Dependencias de la interfaz de CMake target_link

Soy nuevo en CMake y estoy un poco confundido con las palabras clave PUBLIC, PRIVATE e INTERFACE relacionadas con target_link_libraries(). La documentación menciona que se pueden utilizar para especificar tanto las dependencias del enlace como la interfaz del enlace en un solo comando.

¿Qué significan realmente las dependencias de enlace y la interfaz de enlace?

cmake

— Sirish
fuente

Pregunta similar: stackoverflow.com/questions/26243169/…

— TManhente

202

Si está creando una biblioteca compartida y sus archivos cpp de origen #incluyen los encabezados de otra biblioteca (digamos, QtNetwork por ejemplo), pero sus archivos de encabezado no incluyen encabezados QtNetwork, entonces QtNetwork es una PRIVATEdependencia.

Si sus archivos de origen y sus encabezados incluyen los encabezados de otra biblioteca, entonces es una PUBLICdependencia.

Si sus archivos de encabezado, pero no sus archivos de origen, incluyen los encabezados de otra biblioteca, entonces es una INTERFACEdependencia.

Otras propiedades de compilación PUBLICy INTERFACEdependencias se propagan a las bibliotecas consumidoras. http://www.cmake.org/cmake/help/v3.0/manual/cmake-buildsystem.7.html#transitive-usage-requirements

— steveire
fuente

Esta es la explicación más clara de esta pregunta que he escuchado. ¡Ojalá la documentación de cmake fuera tan clara! :-)

— Ela782

Gracias por la explicación, ahora entiendo el significado, pero ¿por qué especificar PUBLICo PRIVATEimporta? ¿Qué cambia?

— user3667089

El uso PRIVATEno agrega sus dependencias a los proyectos que se vinculan a su biblioteca. Es más limpio y también evita posibles conflictos entre tus dependencias y las de tu usuario.

— user2658323

@steveire En aras de la claridad, podría valer la pena declarar explícitamente que "incluir" significa inclusión transitiva, no solo inclusión directa. Por ejemplo, si los archivos de encabezado de otra biblioteca solo están incluidos directamente en sus archivos de encabezado, pero todos sus archivos de encabezado están incluidos en sus archivos de origen, entonces sus archivos de origen incluyen de manera transitiva los archivos de encabezado de la otra biblioteca, por lo que tiene una PUBLICdependencia, no una INTERFACEdependencia.

— Ose

¡La documentación de cmake debería escribirla tan concisa como esta respuesta!

— Bryan Jyh Herng Chong

Dependencias de la interfaz de CMake target_link_libraries