Установка переменных пути и среды при построении из командной строки
Для программ сборки из командной строки Visual C++ требуется несколько переменных среды, соответствующим образом настроенных для установки. При установке Visual Studio создаются командные файлы, которые задают необходимые переменные среды, а затем создаются ярлыки для открытия окна командной строки, в котором эти переменные уже заданы. Если необходимо использовать программы командной строки, можно выбрать один из этих ярлыков или открыть простое окно командной строки, а затем запустить командный файл vcvarsall.bat.
Программы командной строки Visual C++ используют переменные среды PATH, TMP, INCLUDE, LIB и LIBPATH, а также могут использовать переменные среды, связанные с конкретными программами. Так как значения этих переменных среды зависят от установки и могут меняться при обновлении продукта, мы рекомендуем вам использовать файл vcvarsall.bat или ярлык на окно командной строки разработчика вместо того, чтобы настраивать их самостоятельно. Информацию о переменных среды, используемых компилятором и компоновщиком, см. в статьях Переменные среды CL и Переменные среды инструмента LINK.
Примечание
Некоторые программы командной строки и параметры требуют разрешений администратора.Для их использования мы рекомендуем открыть окно командной строки с помощью команды Запуск от имени администратора (в контекстном меню окна командной строки, которое нужно открыть).
Использование ярлыков на окно командной строки
Ярлык "Командная строка разработчика", включенный в каждый выпуск Visual Studio, служит для открытия окна командной строки и настройки среды для использования 32-разрядного набора программ x86 Native, предназначенного для процессоров x86. Также доступны командные строки для 32-разрядных кросс-компиляторов, предназначенных для платформ x64 и ARM. В зависимости от системы и установленного выпуска Visual Studio также может быть доступен ярлык "Командная строка" для 64-разрядного набора программ x64 Native, предназначенного для процессоров x64, и ярлык для 64-разрядного кросс-компилятора, предназначенного для процессоров x86. Эти версии набора программ командной строки доступны во всех выпусках Visual Studio.
x86 для платформы x86
Используйте этот набор программ для создания выходных файлов для компьютеров с архитектурой x86. Он выполняется как 32-разрядный процесс: как машинный код на компьютерах с платформой x86 и как процесс WOW64 на компьютерах с 64-разрядной операционной системой Windows.x64 для платформы x86 (кросс-компилятор x64)
Используйте этот набор программ для создания выходных файлов для x64. Он выполняется как 32-разрядный процесс: как машинный код на компьютерах с платформой x86 и как процесс WOW64 на компьютерах с 64-разрядной операционной системой Windows.ARM для x86 (кросс-компилятор ARM)
Используйте этот набор программ для создания выходных файлов для компьютеров с архитектурой ARM. Он выполняется как 32-разрядный процесс: как машинный код на компьютерах с платформой x86 и как процесс WOW64 на компьютерах с 64-разрядной операционной системой Windows.
Эти версии набора программ командной строки доступны на 64-разрядных платформах.
x86 для x64
Используйте этот набор программ для создания выходных файлов для компьютеров с архитектурой x86. Он выполняется как собственный процесс на компьютере с 64-разрядной операционной системой Windows.x64 для платформы x64
Используйте этот набор программ для создания выходных файлов для компьютеров x64. Он выполняется как собственный процесс на компьютере с 64-разрядной операционной системой Windows.ARM для x64 (кросс-компилятор ARM)
Используйте этот набор программ для создания выходных файлов для компьютеров с архитектурой ARM. Он выполняется как собственный 64-разрядный процесс на компьютере с 64-разрядной операционной системой Windows.
Открытие окна "Командная строка разработчика"
На начальном экране Windows 8 введите "Инструменты Visual Studio". Обратите внимание на то, что результаты поиска меняются по мере ввода. Когда появится пункт Инструменты Visual Studio, выберите его.
В более ранних версиях Windows нажмите кнопку Пуск, а затем в поле поиска введите "Инструменты Visual Studio". Когда в результатах поиска появится пункт Инструменты Visual Studio, выберите его.
В папке Инструменты Visual Studio выберите ярлык Командная строка разработчика для используемой версии Visual Studio. (Для запуска от имени администратора откройте контекстное меню пункта "Командная строка разработчика" и выберите команду Запуск от имени администратора.)
Окно командной строки разработчика настраивает среду для использования собственного 32-разрядного набора программ, предназначенного для процессоров x86. Выберите пункт Командная строка x64 Cross Tools для использования собственного 32-разрядного набора программ, предназначенного для процессоров x64. Выберите пункт Командная строка ARM Cross Tools для использования собственного 32-разрядного набора программ, предназначенного для процессоров ARM. Выберите пункт Командная строка x64 Native Tools для использования собственного 64-разрядного набора программ, предназначенного для процессоров x64.
Использование файла vcvarsall.bat в окне командной строки
Запустив файл vcvarsall.bat в простом окне командной строки, можно задать переменные среды так, чтобы настроить командную строку для использования собственной 32-разрядной или 64-разрядной компиляции либо перекрестной компиляции для процессоров x86, x64 или ARM. Если аргументы не предоставлены, файл vcvarsall.bat настраивает переменные среды для использования собственного 32-разрядного компилятора для целевых платформ x86. Однако его можно использовать для настройки любого из компиляторов. Если указать конфигурацию компилятора, которая не установлена или недоступна в архитектуре компьютера сборки, появится сообщение. В следующей таблице показаны поддерживаемые аргументы.
Аргумент Vcvarsall.bat |
Компилятор |
Архитектура компьютера сборки |
Архитектура выходных данных сборки |
|---|---|---|---|
x86 |
собственный 32-разрядный x86 |
x86, x64 |
x86 |
x86_amd64 |
x64 для x86 (кросс-компилятор) |
x86, x64 |
x64 |
x86_arm |
ARM для x86 (кросс-компилятор) |
x86, x64 |
ARM |
amd64 |
собственный 64-разрядный x64 |
x64 |
x64 |
amd64_x86 |
x86 для x64 (кросс-компилятор) |
x64 |
x86 |
amd64_arm |
ARM для x64 (кросс-компилятор) |
x64 |
ARM |
Ниже приведены инструкции по настройке командной строки для использования собственного 32-разрядного набора программ, предназначенного для платформ x86.
Запуск файла vcvarsall.bat
В командной строке перейдите в каталог установки Visual C++. (Расположение зависит от системы и установки Visual Studio, однако типичное расположение — C:\Program Files (x86)\Microsoft Visual Studio версия\VC\.) Например, введите:
cd "\Program Files (x86)\Microsoft Visual Studio 12.0\VC"
Чтобы настроить окно командной строки для 32-разрядной сборки на платформе x86, введите в командной строке следующую команду.
vcvarsall x86
Visual Studio также предоставляет файл vcvars32.bat для настройки среды командной строки. Файл vcvars32.bat предназначен только для настройки соответствующих переменных среды для 32-разрядных сборок на платформе x86. Его запуск аналогичен выполнению команды vcvarsall x86.
Если вы используете DEVENV для сборки из командной строки, среда, настроенная с помощью файла vcvarsall.bat или vcvars32.bat, не влияет на ваши сборки, если только не указан параметр /useenv.
Предупреждение
Файл vcvarsall.bat может иметь отличия на разных компьютерах.Не заменяйте отсутствующий или поврежденный файл vcvarsall.bat файлом с другого компьютера.Чтобы заменить отсутствующий файл, запустите программу установки Visual Studio повторно.
Файл vcvarsall.bat также может иметь отличия в разных версиях.Если текущая версия Visual C++ установлена на компьютере, на котором также имеется более ранняя версия Visual C++, не запускайте файл vcvarsall.bat или vcvars32.bat из других версий в том же окне командной строки.