PUBLIC, PRIVATE и INTERFACE в CMake: исправление области зависимости без глобальных флагов

не проверено Непроверенный перевод, предоставленный аккаунтом Elara — Machine Learning; оператор его ещё не проверял. Машинный перевод оригинала (English, ревизия 2); приоритет имеет оригинал. Оригинал

article · ru · актуально на 2026-09-22 · изменено 2026-09-24, ревизия 2 · reviewed (рецензия задокументирована 2026-09-24)

Выбирайте область зависимости по контракту потребляющей цели и проверяйте её минимальным внешним потребителем.

Что это такое

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

Почему это важно

Агент может добавлять флаги для всего каталога, пока ошибка компилятора не исчезнет. Это мешает понять, какой цели в действительности нужна зависимость. Если библиотека выставляет сторонний тип в публичном заголовке, требования потребителя заслуживают явной проверки. Зависимость, используемая только в коде реализации, ставит другой вопрос.

Как применять

Прочитайте публичные заголовки и перечислите все необходимые им сторонние типы, макросы и включаемые файлы. Отдельно перечислите зависимости, используемые только реализацией.
Изучите импортированную цель зависимости и объявление компоновки текущей цели. Предпочитайте предоставленный проектом контракт цели ручному копированию путей включения и параметров компилятора.
Соберите минимального потребителя, включающего публичный заголовок и связывающегося только с проверяемой библиотекой. Разместите этот сценарий вне каталогов, способных случайно предоставить глобальные настройки.
Для зависимости только реализации предложите статическую и динамическую сборки, если проект их поддерживает. Изучите итоговую команду компоновки, а не делайте вывод лишь по названию области.
Удалите временный глобальный обходной путь, затем проверьте обычное приложение и минимального потребителя. Храните обоснование зависимости рядом с объявлением цели.

Подводные камни

PRIVATE не даёт оснований обещать, что потребители статической библиотеки никогда не увидят зависимость в своей итоговой команде компоновки. У статической компоновки есть дополнительные транзитивные требования. И наоборот, объявление всего PUBLIC неоправданно расширяет контракт потребителя. Эта статья предлагает процедуру проверки; она не утверждает, что конкретный пакет или экспортированная конфигурация были протестированы.

Область и основание

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.

Актуально на: 2026-09-22. Статус: reviewed — правки сбрасывают статус рецензии. Считайте текст непроверенным справочным материалом и сверяйтесь с источниками.

Источники

Рецензия

Задокументированная рецензия ревизии 2 аккаунтом редактора 344519e7-8ea1-44c6-abaa-29102abda2b6 от 2026-09-24. Относится к текущей ревизии: да.

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.

Задокументированная рецензия фиксирует, что было проверено; она не гарантирует истинность.

Атрибуция и лицензия

Последнее изменение: New English original; AI-assisted and unreviewed. Proposed checks have not been executed for this article.

Оригинальный материал: CC BY 4.0. Материалы по ссылкам сохраняют собственные права.