Использование библиотек и компонентов

2025-04-30

В проектах C++ часто требуется вызывать функции или обращаться к данным в двоичных файлах, таких как статические библиотеки (LIB-файлы), библиотеки DLL, компоненты среды выполнения Windows, компоненты COM или сборки .NET. В этих случаях необходимо настроить проект таким образом, чтобы он мог находить нужные двоичные файлы во время сборки. Конкретный способ сделать это зависит от типа вашего проекта, типа двоичного файла, а также от того, был ли этот двоичный файл собран в том же решении, что и ваш проект.

Использование скачанных библиотек с помощью vcpkg

Чтобы использовать библиотеку, скачаемую с помощью диспетчера пакетов vcpkg , можно игнорировать приведенные ниже инструкции. Дополнительные сведения см. в разделе:

Использование статических библиотек

Если проект статической библиотеки был создан в том же решении:

#include файлы заголовков для статической библиотеки с помощью кавычки. В типовом решении путь начинается с ../<library project name>. При поиске вы можете использовать предложения технологии IntelliSense.
Добавьте ссылку на проект статической библиотеки. Щелкните правой кнопкой мыши ссылки в узле проекта приложения в обозревателе решений и выберите "Добавить ссылку".

Если статическая библиотека не входит в состав решения:

Щелкните правой кнопкой мыши узел проекта приложения в обозревателе решений и выберите пункт "Свойства".
На странице свойств каталогов VC++ добавьте путь к каталогу, который содержит LIB-файл в каталоги библиотеки. Затем добавьте путь к файлам заголовков библиотеки, чтобы включить каталоги.
На странице свойств компоновщика > добавьте имя LIB-файла в дополнительные зависимости.

Библиотеки динамической компоновки

Если библиотека DLL была собрана в рамках того же решения, что и приложение, выполните те же действия, что и для статической библиотеки.

Если библиотека DLL не входит в состав решения приложения, вам потребуются DLL-файл, заголовки с прототипами для экспортируемых функций и классов, а также LIB-файл, содержащий необходимую для компоновки информацию.

Скопируйте DLL-файл в папку выходных данных проекта или другую папку, которая задана в качестве стандартной для поиска библиотек DLL в Windows. Дополнительные сведения см. в Dynamic-Link порядке поиска библиотеки.
Выполните шаги с 1 по 3 для статических библиотек, чтобы задать пути к заголовкам и LIB-файлу.

COM-объекты

Если собственное приложение C++ должно использовать COM-объект и этот объект зарегистрирован, то все, что необходимо сделать, — вызвать CoCreateInstance и передать clSID объекта. Система выполнит поиск объекта в реестре Windows и загрузит его. В проекте C++/CLI COM-объект можно использовать таким же образом. Кроме того, он может использовать его, добавив ссылку на нее из списка добавления ссылок > COM и используя ее через вызываемую оболочку среды выполнения.

Сборки .NET с компонентами среды выполнения Windows

В проектах UWP или C++/CLI используются сборки .NET или компоненты среды выполнения Windows, добавляя ссылку на сборку или компонент. В узле "Ссылки " в проекте UWP или C++/CLI отображаются ссылки на часто используемые компоненты. Щелкните правой кнопкой мыши узел "Ссылки" в обозревателе решений , чтобы открыть диспетчер ссылок и просмотреть компоненты, доступные в системе. Нажмите кнопку "Обзор ", чтобы перейти к любой папке, содержащей настраиваемый компонент. Так как сборки .NET и компоненты среды выполнения Windows содержат встроенные сведения о типе, их методы и классы можно просмотреть, щелкнув правой кнопкой мыши и выбрав представление в браузере объектов.

Свойства ссылки

Каждый тип ссылки имеет свойства. Свойства можно просмотреть, выбрав ссылку в обозревателе решений и нажав клавиши ALT+ВВОД или щелкнув правой кнопкой мыши и выбрав свойства. Одни свойства доступны только для чтения, другие можно изменять. Тем не менее обычно эти свойства не требуется изменять вручную.

Свойства ссылки ActiveX

Свойства ссылки ActiveX доступны только для компонентов COM. Эти свойства отображаются только при выборе COM-компонента в области ссылок . Эти свойства нельзя изменить.

Полный путь к элементу управления

Отображает путь к каталогу элемента управления, на который указывает ссылка.
GUID элемента управления

Отображает GUID для элемента управления ActiveX.
Версия элемента управления

Отображает версию элемента управления ActiveX, на который указывает ссылка.
Имя библиотеки типов

Отображает имя библиотеки типов, на которую указывает ссылка.
Инструмент обертки

Отображает средство, которое используется для создания сборки взаимодействия из указанной библиотеки COM или элемента управления ActiveX.

Свойства ссылки на сборку (C++/CLI)

Свойства ссылки на сборку доступны только для ссылок на сборки .NET Framework в проектах C++/CLI. Эти свойства отображаются только при выборе сборки .NET Framework в области ссылок . Эти свойства нельзя изменить.

Относительный путь

Отображает относительный путь от каталога проекта к сборке, на которую указывает ссылка.

Свойства сборки

Следующие свойства доступны для различных типов ссылок. Они позволяют задавать способ построения со ссылками.

Копировать локально

Указывает, следует ли автоматически копировать сборку, на которую указывает ссылка, в целевое расположение во время сборки.
Копирование локальных спутниковых сборок (C++/CLI)

Указывает, следует ли автоматически копировать вспомогательные сборки ссылочной сборки в целевое расположение во время сборки. Используется только если Copy Localtrue.
Выходные данные эталонной сборки

Указывает, что эта сборка используется в процессе сборки. true означает, что эта сборка используется в командной строке компилятора во время выполнения сборки.

Свойства ссылок проектов на проекты

Следующие свойства задают ссылку типа "проект-проект" от проекта, выбранного в панели Ссылки, к другому проекту в том же решении. Дополнительные сведения см. в разделе "Управление ссылками в проекте".

Зависимости библиотеки ссылок

Если это свойство имеет значение True, система проекта связывает LIB-файлы, создаваемые независимым проектом, в зависимый проект. Как правило, вы укажите True.
Идентификатор проекта

Уникальный идентификатор независимого проекта. Значение свойства — это GUID внутренней системы, который невозможно изменить.
Использование входных данных зависимостей библиотеки

Если это свойство равно False, система проекта не будет связывать OBJ-файлы библиотеки, которую независимый проект создает в зависимый проект. Таким образом, это значение отключает инкрементную компоновку. Как правило, вы укажете false , так как сборка приложения может занять много времени, если существует множество независимых проектов.

Свойства ссылки только для чтения (COM и .NET)

Следующие свойства существуют в ссылках на компоненты COM и сборки .NET, и их нельзя изменить.

Имя сборки

Отображает имя сборки для сборки, на которую указывает ссылка.
Культура

Отображает язык и региональные параметры выбранной ссылки.
Описание

Отображает описание выбранной ссылки.
Полный путь

Отображает путь к каталогу сборки, на которую указывает ссылка.
Идентичность

Для сборок .NET Framework отображает полный путь. Для компонентов COM отображает GUID.
Ярлык

Отображает метку ссылки.
Имя

Отображает имя ссылки.
Маркер открытого ключа

Отображает токен открытого ключа для идентификации сборки, на которую указывает ссылка.
Строгое имя

true, если сборка, на которую указывает ссылка, имеет строгое имя. Сборка со строгим именем имеет уникальную версию.
Версия

Отображает версию сборки, на которую указывает ссылка.

См. также

Справочник по странице свойств проекта C++
Установка свойств компилятора C++ и сборки в Visual Studio