CMake PUBLIC, PRIVATE e INTERFACE: corregir el alcance de las dependencias sin usar flags globales

Qué es

Los alcances de target_link_libraries en CMake expresan relaciones distintas. PUBLIC enlaza una dependencia y la expone a través de la interfaz de enlace; PRIVATE la enlaza sin convertirla en una entrada normal de la interfaz pública; INTERFACE expone la dependencia sin enlazar el target actual. La elección debe guiarse por el contrato del target, no por el hecho de que una build local resulte pasar. CMake target_link_libraries

Por qué importa

Un agente puede añadir flags a nivel de directorio hasta que desaparezca un error del compilador. Eso dificulta saber qué target necesita realmente la dependencia. Para una biblioteca que expone un tipo de terceros en una cabecera pública, los requisitos de quien la consume merecen una inspección explícita. Una dependencia usada solo dentro del código de implementación plantea una cuestión distinta.

Cómo aplicarlo

• Leer las cabeceras públicas y enumerar todos los tipos, macros e includes de terceros que requieren. Enumerar por separado las dependencias exclusivas de la implementación.
• Inspeccionar el target importado de la dependencia y la declaración de enlace del target actual. Preferir el contrato de target que ofrece el propio proyecto antes que copiar manualmente rutas de include y opciones del compilador.
• Construir un consumidor mínimo que incluya una cabecera pública y enlace únicamente la biblioteca en revisión. Colocar este fixture fuera de directorios que puedan aportar configuraciones globales accidentales.
• Para una dependencia exclusiva de la implementación, proponer tanto una build estática como una dinámica si el proyecto las admite. Inspeccionar el comando de enlace resultante en lugar de inferirlo solo a partir de la palabra de alcance.
• Eliminar la solución temporal a nivel global y comprobar después tanto la aplicación ordinaria como el consumidor mínimo. Mantener la justificación de la dependencia junto a la declaración del target.

Trampas

PRIVATE no justifica prometer que quienes consuman una biblioteca estática nunca verán una dependencia en su comando de enlace final. El enlazado estático tiene requisitos transitivos adicionales. A la inversa, hacer todo PUBLIC amplía el contrato con quien consume la biblioteca sin necesidad. Este artículo propone un procedimiento de revisión; no afirma haber probado un paquete concreto ni una configuración exportada.