Настройка компилятора и свойств сборки

В интегрированной среде разработки Visual Studio можно просмотреть и изменить свойства, необходимые для компиляции и сборки проекта. Эти сведения включают имя приложения, расширение (например, DLL, LIB, EXE), параметры компилятора, параметры компоновщика, параметры отладчика и пользовательские шаги сборки.

Эти свойства можно просматривать и изменять с помощью страниц свойств. Чтобы получить доступ к страницам свойств, в главном меню выберите Project и выберите пункт "Свойства". Кроме того, в Обозреватель решений щелкните правой кнопкой мыши узел проекта и выберите пункт "Свойства".

Свойства по умолчанию

При создании проекта система задает значения для различных свойств. Значения по умолчанию варьируются в зависимости от типа проекта и параметров, выбранных в мастере приложений. Например, проект активной библиотеки шаблонов (ATL) имеет свойства, связанные с файлами языка определения интерфейса Майкрософт (MIDL), но эти свойства отсутствуют в базовом консольном приложении. В области "Дополнительно" в окне "Страницы свойств " отображаются свойства по умолчанию:

Применение свойств к конфигурациям сборки и целевым платформам

Некоторые свойства, такие как имя приложения, применяются ко всем вариантам сборки и целевым платформам, будь то отладка или сборка выпуска. Однако большинство свойств зависит от конфигурации. Чтобы создать правильный код, компилятору необходимо знать как конкретную платформу, на которой выполняется программа, так и какие конкретные параметры компилятора следует использовать. Поэтому при установке свойства обратите внимание на конфигурацию и платформу, к которой должно применяться новое значение. Должно ли это применяться только к отладочным сборкам Win32 или также к отладочным сборкам ARM64 и x64? Например, свойство Оптимизации по умолчанию имеет значение Наибольшая скорость (/O2) в конфигурации выпуска, но отключено в конфигурации отладки.

Вы всегда можете просмотреть и изменить конфигурацию и платформу, к которым следует применять значение свойства. На следующем рисунке показаны страницы свойств с элементами управления конфигурацией и сведениями о платформе в верхней части экрана. Когда вы задаёте здесь свойство Optimization, оно применяется только к отладочным сборкам x64 для текущей активной конфигурации, как показано красными стрелками.

На следующем рисунке показана та же страница свойств проекта, но конфигурация изменена на Release. Обратите внимание на другое значение для свойства "Оптимизация". Кроме того, обратите внимание, что активной конфигурацией по-прежнему является отладка. Здесь вы можете задать свойства для любой конфигурации, а не только активной.

Целевые платформы

Целевая платформа относится к типу устройства и операционной системы, на которой выполняется исполняемый файл. Вы можете создать проект для нескольких платформ. Доступные целевые платформы для проектов C++ зависят от типа проекта. Они включают в себя, но не ограничиваются Win32, x64, ARM, ARM64, Android и iOS. Целевая платформа x86, которую можно увидеть в Microsoft Configuration Manager, идентична Win32 в собственных проектах C++. Win32 означает 32-разрядную версию Windows, а x64 — 64-разрядную. Дополнительные сведения об этих двух платформах см. в разделе Запуск 32-разрядных приложений.

Значение любой целевой платформы ЦП , которое может отображаться в Configuration Manager , не влияет на собственные проекты C++. Он относится только к C++/CLI и другим типам проектов .NET. Дополнительные сведения см. в разделе /CLRIMAGETYPE (Указание типа образа СРЕДЫ CLR).

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

• Параметры проекта для конфигурации отладки C++
• Параметры отладчика и подготовка
• Подготовка отладки: типы проектов Microsoft C++
• Указание файлов символов (PDB) и файлов с исходным кодом в отладчике Visual Studio

Параметры компилятора и компоновщика C++

Параметры компилятора и компоновщика C++ находятся в узлах C/C++ и Компоновщик на панели слева в разделе Свойства конфигурации. Эти параметры напрямую соответствуют параметрам командной строки, которые получает компилятор. Чтобы ознакомиться с документацией по конкретному параметру, выберите параметр в центральной области и нажмите клавишу F1. Кроме того, можно просмотреть документацию по всем параметрам компилятора MSVC и параметрам компоновщика MSVC.

В диалоговом окне Страницы свойств отображаются только страницы свойств, относящиеся к текущему проекту. Например, если у проекта нет .idl файла, страница свойств MIDL не отображается. Дополнительные сведения о параметрах на каждой странице свойств см. в разделе "Страницы свойств" (C++).

Значения каталога и пути

MSBuild поддерживает использование констант времени компиляции для определённых строковых значений, таких как каталоги и пути, называемые макросами. Макрос может ссылаться на значение, определенное в Visual Studio или системе MSBuild, или на определяемое пользователем значение. Макросы выглядят как $(macro-name) или %(item-macro-name). Страницы свойств предоставляют эти макросы, к которым можно ссылаться и изменять их с помощью редактора свойств. Используйте макросы вместо жестко закодированных значений, таких как пути к каталогу. Макросы упрощают совместное использование параметров свойств между компьютерами и между версиями Visual Studio. Кроме того, вы можете лучше убедиться, что параметры проекта правильно участвуют в наследовании свойств.

На следующем рисунке показаны страницы свойств для проекта Visual Studio C++. В области слева выбрано правилоКаталоги VC++, а в области справа отображаются свойства, связанные с этим правилом. Значения свойств часто являются макросами, такими как $(VC_SourcePath):

Используйте редактор свойств для просмотра значений всех доступных макросов.

Предустановленные макросы

• Глобальные макросы
  Глобальные макросы применяются ко всем элементам в конфигурации проекта. Глобальный макрос имеет синтаксис $(name). Пример глобального макроса — свойство $(VCInstallDir), которое сохраняет корневой каталог установки Visual Studio. Глобальный макрос соответствует элементу PropertyGroup в MSBuild.

• Макросы элементов
  Макросы элементов имеют синтаксис %(name). Для файла макрос, относящийся к элементу, применяется только к данному файлу. Например, можно указать %(AdditionalIncludeDirectories) включаемые каталоги, которые применяются только к конкретному файлу. Этот тип макроса элемента соответствует метаданным ItemGroup в MSBuild. При использовании в контексте конфигурации проекта макрос элемента применяется ко всем файлам определенного типа. Например, свойство конфигурации C/C++ Определения препроцессора может принимать макрос элемента %(PreprocessorDefinitions), который применяется ко всем CPP-файлам в проекте. Этот тип макроса элемента соответствует метаданным ItemDefinitionGroup в MSBuild. Дополнительные сведения см. в разделе "Определения элементов".

Определяемые пользователем макросы

Создайте пользовательские макросы для использования в качестве переменных в сборках проекта. Например, можно создать пользовательский макрос, предоставляющий значение пользовательскому шагу сборки или пользовательскому средству сборки. Определяемый пользователем макрос — это пара "имя-значение". Для доступа к этому значению в файле проекта используется нотация $(name).

Пользовательский макрос хранится на странице свойств. Если проект еще не содержит лист свойств, его можно создать, выполнив действия, описанные в разделе "Общий доступ" или повторное использование параметров проекта Visual Studio.

Создание пользовательского макроса

1. Откройте окно Диспетчер свойств. В строке меню выберите Вид>Другие окна>Диспетчер свойств. Откройте контекстное меню для листа свойств (имя заканчивается на .user) и выберите Свойства. Откроется диалоговое окно Страницы свойств для данной страницы свойств.

2. В левой области диалогового окна выберите Пользовательские макросы. В правой области нажмите кнопку Добавить макрос, чтобы открыть диалоговое окно Добавление пользовательского макроса.

3. В диалоговом окне задайте имя и значение для макроса. Кроме того, можно установить флажок Задание данного макроса в качестве переменной среды в среде сборки.

Редактор свойств

Используйте редактор свойств для изменения определенных строковых свойств и выбора макросов в качестве значений. Чтобы открыть редактор свойств, выберите свойство на странице свойств, а затем нажмите кнопку со стрелкой вниз справа. Если раскрывающийся список содержит <Изменить>, можно выбрать этот пункт, чтобы открыть редактор этого свойства.

В редакторе свойств нажмите кнопку "Макросы" , чтобы просмотреть доступные макросы и их текущие значения. На следующем рисунке показан редактор свойств для свойства Дополнительные каталоги включаемых файлов после нажатия кнопки Макросы. Если установлен флажок «Наследовать от родительского объекта или настроек проекта по умолчанию» и вы добавляете новое значение, оно добавляется к уже унаследованным значениям. Если снять флажок, новое значение заменяет наследуемые значения. В большинстве случаев оставьте этот флажок отмеченным.

Добавление каталога включения к набору каталогов по умолчанию

При добавлении каталога include в проект не следует переопределять все стандартные каталоги. Добавьте новый путь, например C:\MyNewIncludeDir\, и добавьте $(IncludePath) макрос в значение свойства.

Быстрый просмотр и поиск всех свойств

Страница свойств "Все параметры" (в узле "Свойства>конфигурации C/C++" в диалоговом окне "Страницы свойств") предоставляет быстрый способ просмотра и поиска свойств, доступных в текущем контексте. Она имеет специальное поле поиска и простой синтаксис, который помогает отфильтровать результаты.

• Нет префикса: поиск только в именах свойств (подстрока без учета регистра).

• '/' или '-': поиск только в переключателях компилятора (префикс, нечувствительный к регистру).

• v: поиск только в значениях (подстрока без учета регистра).

Задание переменных среды для сборки

Компилятор MSVC (cl.exe) распознает определенные переменные среды, в частности LIB, LIBPATHPATHи INCLUDE. При сборке с помощью интегрированной среды разработки свойства, заданные на странице свойств каталогов VC++ , задают эти переменные среды. Если значения LIB, LIBPATH и INCLUDE уже заданы, например в командной строке разработчика, то в процессе сборки они заменяются значениями соответствующих свойств MSBuild. Процесс сборки добавляет значение свойства «Каталоги исполняемых файлов» из VC++ Directories в начало PATH. Для задания пользовательской переменной среды можно создать пользовательский макрос и затем установить флажок Задание данного макроса в качестве переменной среды в среде сборки.

Установка переменных среды для сеанса отладки

В левой области диалогового окна Страницы свойств проекта разверните узел Свойства конфигурации и выберите пункт Отладка.

В правой области измените параметры проекта Среда или Объединение среды, а затем нажмите кнопку ОК.

Статьи в этом разделе

• Совместное или повторное использование параметров проекта Visual Studio
• Наследование свойств в проектах Visual Studio
• Изменение свойств и целевых объектов проекта C++ без изменения файла проекта

См. также

• Проекты Visual Studio — C++
• .vcxproj и .props структура файлов
• XML-файлы правил страницы свойств