Пошаговое руководство. Компиляция программы на языке C++/CLI из командной строки
В этом руководстве мы используем текстовый редактор для создания простой программы C++/CLI, а затем компилируем эту программу в командной строке. (Можно использовать вашу собственную программу C++/CLI вместо ввода показанной здесь, или же можно использовать образец кода C++/CLI из другой статьи справки. Эта методика полезна для сборки и тестирования небольших модулей, не содержащих элементы пользовательского интерфейса.)
Предварительные требования
Для работы необходимо владеть основами языка C++.
Компиляция программы на C++/CLI
Компиляция приложения C++/CLI из командной строки
Откройте окно Командная строка разработчика. Дополнительные инструкции см. в разделе Открытие окна «Командная строка разработчика».
В зависимости от операционной системы и конфигурации компьютера для успешной компиляции кода могут потребоваться учетные данные администратора. Чтобы запустить окно командной строки от имени администратора, щелкните правой кнопкой мыши элемент «Командная строка» и выберите команду Дополнительно > Запуск от имени администратора.
Когда появится запрос на создание файла, нажмите кнопку Да.
В Блокноте введите следующие строки:
В строке меню выберите Файл > Сохранить.
Программа выводит следующий текст и закрывается:
Пошаговое руководство. Компиляция программы на языке C++/CX из командной строки
Для новых приложений и компонентов UWP рекомендуется использовать C++/WinRT, стандартную проекцию языка C++17 для API среды выполнения Windows. C++/WinRT доступна в пакете SDK для Windows 10, начиная с версии 1803. C++/WinRT реализована полностью в файлах заголовков и предназначена для предоставления доступа к современным API Windows через первый класс.
Компилятор Microsoft C++ (MSVC) поддерживает расширения компонентов Visual C++ (C++/CX) с дополнительными типами и операторами, предназначенными для программной модели среды выполнения Windows. Можно использовать C++/CX для создания приложений для универсальной платформы Windows (UWP) и классических приложений для Windows. Дополнительные сведения см. в статьях Знакомство с C++/CX и Расширения компонентов для платформ среды выполнения.
В этом руководстве мы используем текстовый редактор для создания простой программы C++/CX, а затем компилируем эту программу в командной строке. (Можно использовать вашу собственную программу C++/CX вместо ввода показанной здесь, или же можно использовать образец кода C++/CX из другой статьи справки. Эта методика полезна для сборки и тестирования небольших модулей, не содержащих элементы пользовательского интерфейса.)
В интегрированной среде разработки (IDE) Visual Studio также можно компилировать программы C++/CX. Интегрированная среда разработки включает средства проектирования, отладки, имитации и поддержки развертывания, недоступные в командной строке, поэтому мы рекомендуем использовать интегрированную среду разработки для создания приложений для универсальной платформы Windows (UWP). Дополнительные сведения см. в разделе Создание приложения UWP на C++.
Предварительные требования
Для работы необходимо владеть основами языка C++.
Компиляция программы на C++/CX
Чтобы включить компиляцию для C++/CX, нужно использовать параметр компилятора /ZW. Компилятор MSVC создает файл EXE, предназначенный для среды выполнения Windows и связанный с необходимыми библиотеками.
Компиляция приложения C++/CX из командной строки
Откройте окно Командная строка разработчика. (В меню Пуск выберите пункт Приложения. Откройте папку Visual Studio Tools для соответствующей версии Visual Studio, а затем выберите ярлык Командная строка разработчика.) Дополнительные сведения об открытии командной строки разработчика см. в статье Использование набора инструментов MSVC из командной строки.
В зависимости от операционной системы и конфигурации компьютера для успешной компиляции кода могут потребоваться учетные данные администратора. Чтобы запустить окно командной строки от имени администратора, щелкните правой кнопкой мыши элемент Командная строка разработчика и выберите команду Запуск от имени администратора.
В командной строке введите следующую команду: notepad basiccx.cpp.
Когда появится запрос на создание файла, нажмите кнопку Да.
В Блокноте введите следующие строки:
В строке меню выберите Файл > Сохранить.
Вы создали файл исходного кода C++, который использует пространство имен платформы среды выполнения.
В командной строке введите следующую команду: cl /EHsc /ZW basiccx.cpp /link /SUBSYSTEM:CONSOLE. Компилятор cl.exe скомпилирует исходный код в OBJ-файл, а затем запустит компоновщик для создания исполняемой программы с именем basiccx.exe. (Параметр компилятора /EHsc указывает модель обработки исключений C++, а параметр /link указывает консольное приложение.)
Чтобы запустить программу basiccx.exe, в командной строке введите basiccx.
Программа выводит следующий текст и закрывается:
Использование набора инструментов Microsoft C++ из командной строки
Вы можете выполнять сборку приложений на языках C и C++ из командной строки с помощью средств, включенных в Visual Studio. Набор инструментов компилятора Microsoft C++ (MSVC) также можно скачать как отдельный пакет. Вам не нужно устанавливать интегрированную среду разработки Visual Studio, если она вам не нужна.
В этой статье описывается, как настроить среду для использования отдельных компиляторов, компоновщиков, библиотекарей и другие основные средства. Собственная система сборки проекта MSBuild не использует среду, как описано в этой статье. Дополнительные сведения об использовании средства MSBuild из командной строки см. в справочнике по использованию MSBuild в командной строке для C++.
Скачивание и установка инструментов
Практическое руководство. Использование программ командной строки
Когда вы выбираете одну из рабочих нагрузок C++ в Visual Studio Installer, он устанавливает набор инструментов платформы Visual Studio. Набор инструментов платформы содержит все средства C и C++ для конкретной версии Visual Studio. К этим средствам относятся компиляторы C/C++, компоновщики, ассемблеры, другие средства сборки и соответствующие библиотеки. Все эти средства можно использовать в командной строке. Они также используются внутри интегрированной среды разработки Visual Studio. Существуют отдельные компиляторы для архитектур x86 и x64 и средства для сборки кода для целевых платформ x86, x 64, ARM и ARM64. Каждый набор средств для конкретного узла и целевой архитектуры сборки хранится в собственном каталоге.
Для правильной работы инструментам требуется несколько переменных среды. Они используются для добавления средств к пути и задания файла включения, файла библиотеки и расположений пакетов SDK. Чтобы упростить процесс задания этих переменных среды, программа установки создает настраиваемые командные файлы, или пакетные файлы, во время установки. Вы можете выполнить один из этих командных файлов, чтобы задать конкретный узел и целевую архитектуру сборки, версию Windows SDK и набор инструментов платформы. Для удобства установщик также создает ярлыки в меню «Пуск». Ярлыки запускают окна командной строки разработчика, используя эти командные файлы для конкретных сочетаний узла и целевого объекта. Эти ярлыки гарантируют, что все необходимые переменные среды установлены и готовы к использованию.
Необходимые переменные среды зависят от установки и выбранной архитектуры сборки. Они также могут изменяться при обновлении продукта. Поэтому рекомендуется использовать ярлык установленной командной строки или командный файл вместо самостоятельной настройки переменных среды.
Устанавливаемые наборы инструментов, командные файлы и ярлыки зависят от процессора компьютера и параметров, выбранных во время установки. Всегда устанавливаются средства, размещаемые на платформе x86, и кросс-компиляции x86 и x64 для сборки кода. Если у вас 64-разрядная версия Windows, будут также установлены средства, размещаемые на платформе x64, и кросс-компиляции x86 и x64 для сборки кода. Если выбрать необязательные средства универсальной платформы Windows для C++, также устанавливаются средства для платформ x86 и x64, которые собирают код ARM и ARM64. Эти и другие инструменты могут быть установлены в других рабочих нагрузках.
Переменные пути и среды для сборок из командной строки
Ярлыки командной строки разработчика
Ярлыки командной строки устанавливаются в папке конкретной версии Visual Studio в меню «Пуск» Windows. Ниже приведен список основных ярлыков командной строки и архитектуры сборки, которые они поддерживают:
Имена ярлыков и папок в меню «Пуск» зависят от установленной версии Visual Studio. Они также зависят от Псевдонима установки, если вы его задали. Например, предположим, что вы установили Visual Studio 2019 и присвоили ей псевдоним Последняя версия. Ярлык командной строки разработчика будет называться Командная строка разработчика для VS 2019 (последняя версия) в папке с именем Visual Studio 2019.
Имена ярлыков и папок в меню «Пуск» зависят от установленной версии Visual Studio. Они также зависят от Псевдонима установки, если вы его задали. Например, предположим, что вы установили Visual Studio 2017 и присвоили ей псевдоним Последняя версия. Ярлык командной строки разработчика называется Командная строка разработчика для VS 2017 (последняя версия) в папке с именем Visual Studio 2017.
Имена ярлыков и папок в меню «Пуск» зависят от установленной версии Visual Studio. Например, предположим, что вы установили Visual Studio 2015. Ярлык командной строки разработчика называется Командная строка разработчика для VS 2015.
Некоторые программы командной строки и параметры могут требовать разрешений администратора. Если при их использовании возникают проблемы с разрешениями, мы рекомендуем открыть окно командной строки разработчика с помощью команды Запуск от имени администратора. В Windows 10 откройте контекстное меню для окна командной строки, а затем выберите команду Дополнительно > Запуск от имени администратора.
Открытие окна «Командная строка разработчика»
На рабочем столе откройте меню Пуск Windows, прокрутите вниз, чтобы найти и открыть папку вашей версии Visual Studio, например Visual Studio 2019.
В папке выберите ярлык Командная строка разработчика для вашей версии Visual Studio. Этот ярлык запускает окно командной строки разработчика, которое использует архитектуру сборки по умолчанию: 32-разрядные собственные инструменты x86 для сборки 32-разрядного машинного кода x86. Если вы предпочитаете архитектуру сборки не по умолчанию, выберите одну из собственных командных строк или командную строку инструментов кросс-компиляции, чтобы указать узел и целевую архитектуру.
Более быстрый способ открыть командную строку разработчика — ввести запрос командная строка разработчика в поле поиска на рабочем столе. Затем выберите нужный результат.
Расположение командных файлов разработчика
Если вам необходимо установить среду сборки в открытом окне командной строки, можно использовать один из командных файлов, созданных установщиком. Рекомендуем задавать среду в новом окне командной строки. Не рекомендуется менять среды позднее в том же окне командной строки.
Расположение командного файла зависит от установленной версии Visual Studio и расположения, выбранного во время установки. Visual Studio 2019 обычно устанавливается в 64-разрядной системе в папке \Program Files (x86)\Microsoft Visual Studio\2019\выпуск. Выпуском может быть Community, Professional, Enterprise, Build Tools или другой введенный псевдоним.
Расположение командного файла зависит от установленной версии Visual Studio и расположения, выбранного во время установки. Visual Studio 2017 обычно устанавливается в 64-разрядной системе в папке \Program Files (x86)\Microsoft Visual Studio\2017\выпуск. Выпуском может быть Community, Professional, Enterprise, Build Tools или другой введенный псевдоним.
Расположение командного файла зависит от версии Visual Studio и каталога установки. Visual Studio 2015 обычно устанавливается в папке \Program Files (x86)\Microsoft Visual Studio 14.0.
Основной командный файл командной строки разработчика VsDevCmd.bat находится в подкаталоге Common7\Tools. Если параметры не указаны, он указывает среде использовать собственные инструменты x86 для создания 32-разрядного кода x86.
Для настройки конкретных архитектур сборки доступны дополнительные командные файлы. Доступные командные файлы зависят от установленных рабочих нагрузок и параметров Visual Studio. Для Visual Studio 2017 и Visual Studio 2019 они будут находиться в подкаталоге VC\Auxiliary\Build.
Для настройки конкретных архитектур сборки доступны дополнительные командные файлы. Доступные командные файлы зависят от установленных рабочих нагрузок и параметров Visual Studio. В Visual Studio 2015 они находятся в подкаталогах VC, VC\bin или VC\bin\архитектура, где архитектура — собственный вариант или кросс-компилятор.
Файл vcvarsall.bat и другие командные файлы Visual Studio могут различаться на разных компьютерах. Не заменяйте отсутствующий или поврежденный файл vcvarsall.bat файлом с другого компьютера. Перезапустите Visual Studio Installer, чтобы заменить отсутствующий файл.
Файл vcvarsall.bat также может различаться в разных версиях. Если текущая версия Visual Studio установлена на компьютере, на котором также имеется более ранняя версия Visual Studio, не запускайте файл vcvarsall.bat или другой командный файл других версий в том же окне командной строки.
Использование средств разработчика в существующем окне командной строки
Если аргументы не используются, файл vcvarsall.bat настраивает переменные среды для использования текущего собственного компилятора x86 для 32-разрядных целевых классических приложений Windows. Можно добавить аргументы, чтобы настроить среду для использования собственных инструментов или инструментов кросс-компиляции. Файл vcvarsall.bat выводит сообщение об ошибке, если указанная конфигурация не установлена или недоступна на компьютере.
Синтаксис vcvarsall
vcvarsall.bat [ architecture ] [ platform_type ] [ winsdk_version ] [ -vcvars_ver= vcversion ] [ spectre_mode ]
architecture
Этот необязательный аргумент указывает узел и целевую архитектуру для использования. Если параметр architecture не указан, используется среда сборки по умолчанию. Поддерживаются следующие аргументы:
| architecture | Компилятор | Архитектура главного компьютера | Архитектура выходных данных сборки (целевая) |
|---|---|---|---|
| x86 | собственный 32-разрядный x86 | x86, x64 | x86 |
| x86_amd64 или x86_x64 | x64 для x86 (кросс-компилятор) | x86, x64 | X64 |
| x86_arm | ARM для x86 (кросс-компилятор) | x86, x64 | ARM |
| x86_arm64 | ARM64 для x86 (кросс-компилятор) | x86, x64 | ARM64 |
| amd64 или x64 | Собственный 64-разрядный x64 | X64 | X64 |
| amd64_x86 или x64_x86 | x86 для x64 (кросс-компилятор) | X64 | x86 |
| amd64_arm или x64_arm | ARM для x64 (кросс-компилятор) | X64 | ARM |
| amd64_arm64 или x64_arm64 | ARM64 для x64 (кросс-компилятор) | X64 | ARM64 |
platform_type
Этот необязательный аргумент позволяет указать store или uwp в качестве типа платформы. По умолчанию среда настроена на сборку классических или консольных приложений.
vcversion
При необходимости указывает набор инструментов компилятора Visual Studio для использования. По умолчанию среда должна использовать текущий набор инструментов компилятора Visual Studio.
Используйте -vcvars_ver=14.2x.yyyyy, чтобы указать конкретную версию набора инструментов компилятора Visual Studio 2019.
Используйте -vcvars_ver=14.29, чтобы указать последнюю версию набора инструментов компилятора Visual Studio 2019.
Используйте -vcvars_ver=14.16, чтобы указать последнюю версию набора инструментов компилятора Visual Studio 2017.
Используйте -vcvars_ver=14.1x.yyyyy, чтобы указать конкретную версию набора инструментов компилятора Visual Studio 2017.
Используйте -vcvars_ver=14.0, чтобы указать набор инструментов компилятора Visual Studio 2015.
Настройка среды сборки в существующем окне командной строки
В командной строке выполните команду CD, чтобы перейти на каталог установки Visual Studio. Затем снова используйте CD, чтобы перейти в подкаталог, который содержит зависящие от конфигурации командные файлы. Для Visual Studio 2019 и Visual Studio 2017 используется подкаталог VC\Auxiliary\Build. Для Visual Studio 2015 используйте подкаталог VC.
Введите команду для вашей среды разработки. Например, для сборки кода ARM для универсальной платформы Windows на 64-разрядной платформе с последней версией Windows SDK и набором инструментов компилятора Visual Studio используйте эту командную строку:
vcvarsall.bat amd64_arm uwp
Создание собственных ярлыков командной строки
Откройте диалоговое окно свойств для ярлыка командной строки разработчика, чтобы увидеть использованный целевой объект команды. Например, целевой объект для ярлыка командной строки Native Tools x64 для VS 2019 выглядит примерно следующим образом:
%comspec% /k «C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat»
Откройте диалоговое окно свойств для ярлыка командной строки разработчика, чтобы увидеть использованный целевой объект команды. Например, целевой объект для ярлыка командной строки Native Tools x64 для VS 2017 выглядит примерно следующим образом:
%comspec% /k «C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars64.bat»
Откройте диалоговое окно свойств для ярлыка командной строки разработчика, чтобы увидеть использованный целевой объект команды. Например, целевой объект для ярлыка командной строки Native Tools x64 для VS 2015 выглядит примерно следующим образом:
%comspec% /k «C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat» amd64
Измените путь, чтобы указать каталог установки Visual Studio. Файл vcvarsall.bat содержит дополнительную информацию об определенных номерах версии.
Средства командной строки
Для сборки проекта C/C++ из командной строки Visual Studio предоставляет следующие программы командной строки:
CL
Используйте компилятор (cl.exe) для компиляции и компоновки файлов исходного кода в приложения, библиотеки и DLL.
Link
Используйте компоновщик (link.exe) для компоновки скомпилированных объектных файлов и библиотек в приложения и DLL.
NMAKE
Используйте NMAKE (nmake.exe) в Windows для создания проектов C++ на основе традиционного файла makefile.
При сборке в командной строке команда F1 для получения мгновенной справки недоступна. Вместо этого используйте поисковую систему для получения сведений о предупреждениях, ошибках и сообщениях. Также можно скачать и применить автономные файлы справки. Чтобы использовать функцию поиска в docs.microsoft.com, введите строку поиска в поле поиска в верхней части любой статьи.
Средства управления проектами из командной строки
В интегрированной среде разработки Visual Studio используется собственная система сборки проектов на основе MSBuild. Вы можете вызвать MSBuild напрямую или использовать собственную систему сборки проектов без интегрированной среды разработки:
MSBuild
Используйте MSBuild (msbuild.exe) и файл проекта (VCXPROJ) для настройки сборки и косвенного вызова набора инструментов. Это аналогично выполнению команд Собрать проект или Собрать решение в интегрированной среде разработки Visual Studio. Запуск MSBuild из командной строки является усложненным сценарием и обычно не рекомендуется. Начиная с Visual Studio 2019 версии 16.5, MSBuild не использует окружение командной строки для управления набором инструментов и используемыми библиотеками.
Содержание раздела
В этих статьях показано, как создавать приложения в командной строке, а также описано, как настроить среду сборки из командной строки. В некоторых из них показано, как использовать 64-разрядные наборы инструментов и целевые платформы x86, x64, ARM и ARM64. Они также описывают использование средств сборки из командной строки MSBuild и NMAKE.
Пошаговое руководство: компиляция программы на языке C++/CX из командной строки
Описывается создание и компиляция программы C++/CX, в которой используется среда выполнения Windows.
NMAKE reference (Справочник по NMAKE)
Содержит ссылки на статьи, в которых описывается служебная программа обслуживания программ Майкрософт (NMAKE.EXE).
MSBuild в командной строке — C++
Содержит ссылки на статьи, в которых рассматривается использование программы msbuild.exe из командной строки.
Связанные разделы
/MD, /MT, /LD (использование библиотеки времени выполнения)
Описывается использование этих параметров компилятора для работы с библиотекой времени выполнения отладки или выпуска.
Параметры компилятора C/C++
Содержит ссылки на статьи, посвященные параметрам компилятора C и C++, а также программе CL.exe.
Параметры компоновщика MSVC
Содержит ссылки на статьи, посвященные параметрам компоновщика и программе LINK.exe.
Дополнительные средства сборки MSVC
Содержит ссылки на средства сборки C/C++, включенные в состав Visual Studio.
Практическое руководство. Вызов компилятора командной строки (Visual Basic)
Вы можете вызвать компилятор командной строки, указав имя исполняемого файла в командной строке, которая также называется командной строкой MS-DOS. При компиляции из командной строки Windows по умолчанию необходимо ввести полный путь к исполняемому файлу. Чтобы переопределить это поведение по умолчанию, можно либо использовать командную строку разработчика для Visual Studio, либо изменить переменную среды PATH. Оба варианта позволяют выполнять сборку из любого каталога при вводе имени компилятора.
Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в следующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Персонализация среды IDE.
Вызов компилятора с помощью командной строки разработчика для Visual Studio
Откройте папку «Инструменты Visual Studio» в группе программы Microsoft Visual Studio.
Если на вашем компьютере установлена среда Visual Studio, вы можете использовать командную строку разработчика для Visual Studio, чтобы получить доступ к компилятору из любого каталога на компьютере.
Запустите командную строку разработчика для Visual Studio.
В командной строке введите vbc.exe имя исходного файла и нажмите клавишу ВВОД.
Установка переменной среды PATH компилятора для командной строки Windows
С помощью функции «Поиск» Windows найдите файл Vbc.exe на локальном диске.
В меню Пуск щелкните правой кнопкой мыши Мой компьютер, а затем в контекстном меню выберите Свойства.
Перейдите на вкладку Дополнительно, затем выберите Переменные среды.
В области Системные переменные выберите Путь из списка и щелкните Изменить.
В диалоговом окне Изменение системной переменной переместите курсор в конец строки в поле Значение переменной и введите точку с запятой (;) и полное имя каталога, полученное на шаге 1.
Нажмите кнопку ОК для подтверждения изменений и закрытия диалоговых окон.
После изменения переменной среды PATH можно запустить компилятор Visual Basic в командной строке Windows из любого каталога на компьютере.
Вызов компилятора с помощью командной строки Windows
В меню Пуск выберите папку Стандартные, а затем откройте командную строку Windows.
