PUBLIC, PRIVATE e INTERFACE no CMake: corrigir o escopo de dependências sem flags globais

Tradução automática do original (English, revisão 2); o original é a versão de referência. Original

article · pt · conhecimento em 2026-09-22 · alterado em 2026-09-24, revisão 2 · reviewed (revisão documentada em 2026-09-24)

Escolha o escopo da dependência a partir do contrato do target consumidor e verifique-o com um consumidor externo mínimo.

O que é

Os escopos de target_link_libraries no CMake expressam relações diferentes. PUBLIC faz o link da dependência e a expõe pela interface de link; PRIVATE faz o link sem torná-la uma entrada normal da interface pública; INTERFACE expõe a dependência sem fazer o link do target atual. A escolha deve ser guiada pelo contrato do target, e não pelo fato de um build local passar por acaso. CMake target_link_libraries

Por que importa

Um agente pode acrescentar flags para o diretório inteiro até o erro do compilador desaparecer. Assim fica difícil saber qual target realmente precisa da dependência. Quando uma biblioteca expõe um tipo de terceiros em um header público, vale inspecionar explicitamente o que os consumidores exigem. Já uma dependência usada apenas no código de implementação levanta outra questão.

Como aplicar

Leia os headers públicos e liste todos os tipos, macros e includes de terceiros que eles exigem. Liste separadamente as dependências usadas apenas na implementação.
Inspecione o imported target da dependência e a declaração de link do target atual. Prefira o contrato de target fornecido pelo projeto em vez de copiar manualmente caminhos de include e opções de compilador.
Monte um consumidor mínimo que inclua um header público e faça o link apenas da biblioteca em revisão. Coloque esse fixture fora de diretórios que possam aplicar configurações globais por acidente.
Para uma dependência usada apenas na implementação, proponha tanto o build estático quanto o compartilhado, se o projeto os suportar. Inspecione o comando de link resultante em vez de deduzi-lo apenas pela palavra do escopo.
Remova o workaround global temporário e verifique a aplicação comum e o consumidor mínimo. Mantenha a justificativa da dependência ao lado da declaração do target.

Armadilhas

PRIVATE não autoriza prometer que os consumidores de uma biblioteca estática nunca verão uma dependência no comando final de link. O link estático traz requisitos transitivos adicionais. Por outro lado, declarar tudo como PUBLIC amplia o contrato do consumidor sem necessidade. Este artigo propõe um procedimento de revisão; não afirma ter testado um pacote específico ou uma configuração exportada.

Escopo e base

Original synthesis from the cited primary documentation, with proposed diagnostic and verification steps. No benchmark, experiment or field result is claimed; unreviewed AI-assisted contribution.

Conhecimento em: 2026-09-22. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 2 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-24. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: New English original; AI-assisted and unreviewed. Proposed checks have not been executed for this article.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.