Общие макросы для команд и свойств MSBuild

  • Статья

В зависимости от параметров установки Visual Studio может сделать сотни макросов доступными для вас в проекте Visual Studio на основе .vcxproj MSBuild. Макросы соответствуют свойствам MSBuild, заданным по умолчанию или файлам .props .targets или параметрам проекта. Эти макросы можно использовать в любом месте диалогового окна Страницы свойств проекта, где допустимы строки. Эти макросы не учитывает регистр.

Просмотр текущих свойств и макросов

Чтобы отобразить все доступные макросы, откройте страницы свойств проекта в главном меню, выбрав "Свойства проекта>". В диалоговом окне "Страницы свойств" выберите запись с макросом. Макрос можно распознать по знаку доллара и скобкам, окружающим его имя.

Например, в левой области выберите "Свойства>конфигурации" каталогов VC++, а затем в правой области выберите "Включить каталоги". Значением для каталогов Include является $(VC_IncludePath);$(WindowsSDK_IncludePath);.

Знак доллара и скобки, окружающие эти два значения, указывают на то, что они макросы. Расширение этих двух макросов задает каталоги включения для поиска.

Выберите " Включить каталоги " и раскрывающийся список появится в конце строки. Нажмите кнопку раскрывающегося списка, а затем нажмите кнопку "Изменить". В появившемся диалоговом окне "Включить каталоги" нажмите кнопку "Макросы>>".

Это расширяет диалоговое окно, чтобы отобразить текущий набор свойств и макросов, видимых Visual Studio, а также текущее значение для каждого. Дополнительные сведения см. в разделе "Указание определяемых пользователем значений" на странице свойств проекта C++ .

Снимок экрана: диалоговое окно

Список общих макросов

В этой таблице описывается часто используемое подмножество доступных макросов; Здесь еще много не перечислены. Перейдите в диалоговое окно "Макросы" , чтобы просмотреть все свойства и их текущие значения в проекте. Дополнительные сведения о создании и использовании определений свойств MSBuild в качестве макросов в , .targetsа также .vcxproj файлах см. в .propsразделе "Свойства MSBuild".

Макрос Description
$(Configuration) Имя текущей конфигурации проекта, например "Debug".
$(DevEnvDir) Каталог установки Visual Studio (определяется как диск + путь); включает конечную обратную косую черту (\).
$(FrameworkDir) Каталог, в котором установлена платформа .NET Framework.
$(FrameworkSDKDir) Каталог, в котором установлена платформа .NET Framework. Возможно, платформа .NET Framework были установлены как часть Visual Studio или отдельно.
$(FrameworkVersion) Версия платформы .NET Framework, используемая Visual Studio. В сочетании с $(FrameworkDir)полным путем к версии платформа .NET Framework, используемой Visual Studio.
$(FxCopDir) Путь к файлу fxcop.cmd. Файл fxcop.cmd не установлен во всех выпусках Visual Studio.
$(IntDir) Путь к каталогу, заданному для промежуточных файлов. Если это относительный путь, промежуточные файлы переходят к этому пути, добавленным в каталог проекта. Этот путь должен иметь конечную обратную косую черту (\). Он разрешает значение свойства Промежуточного каталога . Не используйте $(OutDir) для определения этого свойства.
$(OutDir) Путь к каталогу выходных файлов. Если это относительный путь, выходные файлы переходят к этому пути, добавленному в каталог проекта. Этот путь должен иметь конечную обратную косую черту (\). Он разрешает значение свойства Output Directory . Не используйте $(IntDir) для определения этого свойства.
$(Platform) Имя текущей платформы проекта, например Win32.
$(PlatformShortName) Короткое имя текущей архитектуры, например x86 или x64.
$(ProjectDir) Каталог проекта (определяется как диск + путь); включает конечную обратную косую черту (\).
$(ProjectExt) Расширение файла проекта. Включает символ "." перед расширением файла.
$(ProjectFileName) Имя файла проекта (определяется как базовое имя + расширение файла).
$(ProjectName) Базовое имя проекта.
$(ProjectPath) Абсолютный путь к проекту (определяется как диск + путь + базовое имя + расширение файла).
$(PublishDir) Расположение выходных данных для целевого объекта публикации; включает конечную обратную косую черту (\). По умолчанию используется $(OutDir)app.publish\ папка.
$(RemoteMachine) Задайте значение свойства Remote Machine на странице свойств отладки. Дополнительные сведения см. в разделе "Изменение параметров проекта" для конфигурации отладки C/C++.
$(RootNameSpace) Пространство имен (при наличии), содержащее приложение.
$(SolutionDir) Каталог решения (определенный как диск + путь); включает конечную обратную косую черту (\). Он определяется только при сборке решения в интегрированной среде разработки.
$(SolutionExt) Расширение файла решения. Включает символ "." перед расширением файла. Он определяется только при сборке решения в интегрированной среде разработки.
$(SolutionFileName) Имя файла решения (определяется как базовое имя + расширение файла). Он определяется только при сборке решения в интегрированной среде разработки.
$(SolutionName) Базовое имя решения. Он определяется только при сборке решения в интегрированной среде разработки.
$(SolutionPath) Абсолютный путь к решению (определяется как диск + путь + базовое имя + расширение файла). Он определяется только при сборке решения в интегрированной среде разработки.
$(TargetDir) Каталог первичного выходного файла сборки (определяется как диск + путь); включает конечную обратную косую черту (\).
$(TargetExt) Расширение имени основного выходного файла сборки. Включает символ "." перед расширением файла.
$(TargetFileName) Имя основного выходного файла для сборки (определяется как базовое имя + расширение файла).
$(TargetName) Базовое имя основного выходного файла сборки.
$(TargetPath) Абсолютный путь к основному выходному файлу для сборки (определяется как диск + путь + базовое имя + расширение файла).
$(VCInstallDir) Каталог с содержимым C++ из установки Visual Studio. Это свойство содержит версию целевого набора инструментов Microsoft C++ (MSVC), который может отличаться от используемого в узле Visual Studio. Например, при сборке с $(PlatformToolset) = v140помощью содержит $(VCInstallDir) путь к установке Visual Studio 2015.
$(VSInstallDir) Каталог, в котором установлено программное обеспечение Visual Studio. Это свойство содержит версию целевого набора инструментов Visual Studio, которая может отличаться от основного приложения Visual Studio. Например, при сборке с $(PlatformToolset) = v110помощью содержит $(VSInstallDir) путь к установке Visual Studio 2012.
$(WebDeployPath) Относительный путь от корня веб-развертывания до каталога выходных данных проекта.
$(WebDeployRoot) Абсолютный путь к расположению <localhost>. Например, c:\inetpub\wwwroot.

Устаревшие макросы

Система сборки для C++ была значительно изменена между Visual Studio 2008 и Visual Studio 2010. Многие макросы, используемые в предыдущих типах проектов, изменились на новые. Эти макросы больше не используются или заменяются одним или несколькими эквивалентными свойствами или значениями макроса%(item-name) метаданных элемента. Средство миграции может обновить макросы, помеченные как "перенесенные". Если проект, содержащий макрос, переносится из Visual Studio 2008 или более ранней версии в Visual Studio 2010, Visual Studio преобразует макрос в эквивалентный текущий макрос. Более поздние версии Visual Studio не могут преобразовывать проекты с Visual Studio 2008 и более ранних версий в новые типы проектов. Необходимо преобразовать эти проекты в два этапа — сначала преобразуйте их в Visual Studio 2010, а затем преобразуйте результат для более новой версии Visual Studio. Дополнительные сведения см. в статье Общие сведения о возможных проблемах, возникающих при обновлении.

Макрос Description
$(InputDir) (Перенесено.) Каталог входного файла (определяется как диск + путь); включает конечную обратную косую черту (\). Если проект является входным, этот макрос эквивалентен $(ProjectDir).
$(InputExt) (Перенесено.) Расширение файла ввода. Включает символ "." перед расширением файла. Если проект является входным, этот макрос эквивалентен $(ProjectExt). Для исходных файлов это эквивалентно %(Extension).
$(InputFileName) (Перенесено.) Имя файла ввода (определяется как базовое имя и расширение файла). Если проект является входным, этот макрос эквивалентен $(ProjectFileName). Для исходных файлов это эквивалентно %(Identity).
$(InputName) (Перенесено.) Базовое имя входного файла. Если проект является входным, этот макрос эквивалентен $(ProjectName). Для исходных файлов это эквивалентно %(Filename).
$(InputPath) (Перенесено.) Абсолютное имя входного файла (определяется как диск + путь + базовое имя + расширение файла). Если проект является входным, этот макрос эквивалентен $(ProjectPath). Для исходных файлов это эквивалентно %(FullPath).
$(ParentName) Имя элемента, содержащего данный элемент проекта. Этот макрос — это имя родительской папки или имя проекта.
$(SafeInputName) Имя файла как допустимое имя класса (без расширения файла). Это свойство не имеет точного эквивалента.
$(SafeParentName) Имя непосредственного родителя в допустимом формате. Например, форма является родительским элементом .resx файла. Это свойство не имеет точного эквивалента.
$(SafeRootNamespace) Имя пространства имен, в котором мастера проекта должны добавить код. Это имя пространства имен содержит только символы, которые разрешены в допустимом идентификаторе C++. Это свойство не имеет точного эквивалента.

См. также

Проекты Visual Studio — C++
Руководство по переносу и обновлению Visual C++
Общие сведения о возможных проблемах, возникающих при обновлении
Общеизвестные метаданные элементов MSBuild