CMake target_link_libraries Зависимости интерфейса

Я новичок в CMake и немного запутался ключевыми словами PUBLIC, PRIVATE и INTERFACE, относящимися к target_link_libraries(). В документации упоминается, что их можно использовать для указания как зависимостей ссылок, так и интерфейса ссылки в одной команде.

Что на самом деле означают зависимости ссылок и интерфейс ссылок?

cmake

— Сириш
источник

Аналогичный вопрос: stackoverflow.com/questions/26243169/…

— TManhente

202

Если вы создаете разделяемую библиотеку и ваши исходные файлы cpp # включают заголовки другой библиотеки (скажем, QtNetwork, например), но ваши файлы заголовков не включают заголовки QtNetwork, тогда QtNetwork является PRIVATEзависимостью.

Если ваши исходные файлы и ваши заголовки включают заголовки другой библиотеки, то это PUBLICзависимость.

Если ваши файлы заголовков, но не исходные файлы, включают заголовки другой библиотеки, то это INTERFACEзависимость.

Другие свойства сборки PUBLICи INTERFACEзависимости распространяются на библиотеки-потребители. http://www.cmake.org/cmake/help/v3.0/manual/cmake-buildsystem.7.html#transitive-usage-requirements

— Стивир
источник

Это наиболее ясное объяснение этого вопроса, которое я когда-либо слышал. Хотелось бы, чтобы документация по cmake была максимально ясной! :-)

— Ela782 07

Спасибо за объяснение. Теперь я понимаю смысл, но почему уточнение PUBLICили PRIVATEимеет значение? Что это меняет?

— user3667089

Использование PRIVATEне добавляет ваши зависимости к проектам, связанным с вашей библиотекой. Он чище, а также позволяет избежать возможных конфликтов между вашими зависимостями и вашим пользователем.

— user2658323

@steveire Для ясности, возможно, стоит прямо указать, что «включить» означает транзитивное включение, а не просто прямое включение. Например, если файлы заголовков другой библиотеки включены только напрямую в ваши файлы заголовков, но все ваши файлы заголовков включены в исходные файлы, то ваши исходные файлы транзитивно включают файлы заголовков другой библиотеки, и поэтому у вас есть PUBLICзависимость, а не INTERFACEзависимость.

— Ose

Документация по cmake должна быть такой же краткой, как и этот ответ!

— Bryan Jyh Herng Chong,