Параметры командной строки для команды Devenv

Команда Devenv предоставляет возможность установки из командной строки различных параметров для интегрированной среды разработки (IDE), а также для компиляции, построения и отладки проектов. Используйте эти переключатели для запуска IDE из файла скрипта или из BAT-файла, например скрипта построения программы в ночное время, либо для запуска IDE в особой конфигурации.

Примечание

Для задач, связанных с построением, теперь рекомендуется использовать MSBuild вместо devenv.Дополнительные сведения см. в разделе Справочные сведения о командной строке MSBuild.

Примечание

Для использования параметров /Setup (devenv.exe) и /InstallVSTemplates (devenv.exe) запускать devenv следует с правами администратора.Дополнительные сведения см. в разделе User Rights and Visual Studio.

Синтаксис переключателей команды Devenv

По умолчанию команды devenv подставляют переключатели в программу devenv.com.

Использование devenv.com обеспечивает доставку выходных данных с помощью стандартных системных потоков, таких как stdout и stderr, а также правильную переадресацию ввода/вывода при захвате выходных данных, например в TXT-файл. Для команд, начинающихся с devenv.exe, можно использовать те же переключатели, но они будут отправляться в программу devenv.exe, обходя служебную программу devenv.com.

Правила синтаксиса для переключателей devenv соответствуют правилам, которые похожи на правила для других служебных программ, управляемых из командной строки DOS. Следующие синтаксические правила действуют для всех переключателей и аргументов devenv:

  • Команды начинаются с devenv.

  • При наборе переключателей регистр знаков не учитывается.

  • При указании решения или проекта первым аргументом будет имя файла решения или файла проекта, включающее путь к файлу.

  • Если первый аргумент – это файл, который не является решением или проектом, то этот файл будет открыт в соответствующем редакторе, в новом экземпляре интерфейса IDE.

  • Если вместо имени файла решения указать имя файла проекта, команда devenv выполнит поиск файла решения с этим именем в родительской папке файла проекта. Например, команда devenv /build myproject1.vbproj выполнит поиск файла решения с именем "myproject1.sln" в родительской папке.

    Примечание

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

  • Пути файлов и имена файлов, содержащие пробелы, должны заключаться в двойные кавычки (""). Например, "c:\project a\".

  • Разделяйте переключатели и аргументы на одной строке одиночными пробелами. Например, команда devenv /log output.txt открывает интерфейс IDE и выводит все данные журнала для данного сеанса в файл output.txt.

  • Подстановочные знаки или другой синтаксис по шаблону нельзя использовать в командах devenv.

Переключатели команды Devenv

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

Переключатель командной строки

Описание

/Command (devenv.exe)

Запускает интегрированную среду разработки (IDE) и выполняет указанную команду.

/DebugExe (devenv.exe)

Загружает исполняемый файл Visual C++ под управлением отладчика. Этот переключатель недоступен для исполняемых файлов Visual Basic и Visual C#. Дополнительные сведения см. в разделе Практическое руководство. Автоматический запуск отладки.

/LCID (devenv.exe) или /l

Устанавливает для интегрированной среды разработки (IDE) язык по умолчанию. Если указанный язык не включается в установку Visual Studio, то этот параметр будет игнорироваться.

/Log (devenv.exe)

Запускает Visual Studio и записывает все события в файл журнала.

/Run (devenv.exe) или /r

Компилирует и выполняет указанное решение.

/Runexit (devenv.exe)

Компилирует и выполняет указанное решение, минимизируя интегрированную среду разработки (IDE) при выполнении решения и закрывая IDE после завершения выполнения.

/UseEnv (devenv.exe)

Инициирует использование в интегрированной среде разработки (IDE) переменных среды PATH, INCLUDE и LIB для компиляции на Visual C++ вместо параметров, установленных в диалоговом окне Параметры в разделе “Каталоги VC++” параметров проектов. Дополнительные сведения см. в разделе Установка переменных пути и среды при построении из командной строки.

/Edit (devenv.exe)

Открывает указанные файлы в запущенном экземпляре этого приложения. Если нет запущенных экземпляров, то запускается новый экземпляр с упрощенной структурой окна.

/ResetAddin (devenv.exe)

Запускает экземпляр среды Visual Studio IDE без загрузки указанной надстройки.

/SafeMode (devenv.exe)

Запускает Visual Studio в безопасном режиме и загружает только среду и службы по умолчанию, а также прилагаемые версии сторонних пакетов.

/ResetSkipPkgs (devenv.exe)

Удаляет все теги SkipLoading, добавленные к VSPackages пользователями, желающими исключить загрузку проблемных VSPackages.

/Setup (devenv.exe)

Вызывает в Visual Studio принудительное объединение метаданных ресурсов, описывающих меню, панели инструментов и группы команд, из всех доступных пакетов VSPackage.

Используйте следующие переключатели командной строки для выполнения описываемых задач. Эти переключатели командной строки не позволяют отобразить интегрированную среду разработки (IDE).

Переключатель командной строки

Описание

/? (devenv.exe)

Отображает внутри окна Командная строка справку по переключателям.

Devenv /?

/Build (devenv.exe)

Выполняет построение указанного решения или проекта согласно конфигурации заданного решения.

Devenv myproj.csproj /build

/Clean (devenv.exe)

Удаляет любые файлы, созданные командой построения, не затрагивая исходные файлы.

Devenv myproj.csproj /clean

/Deploy (devenv.exe)

Выполняется построение решения наряду с файлами, необходимыми для развертывания, согласно конфигурации решений.

Devenv myproj.csproj /deploy

/InstallVSTemplates (devenv.exe)

Регистрация проекта или шаблонов элемента, расположенных в <VisualStudioInstallDir>\Common7\IDE\ProjectTemplates\ или <VisualStudioInstallDir>\Common7\IDE\ItemTemplates\, что позволяет обращаться к ним из диалоговых окон Создание проекта и Добавление нового элемента.

Devenv /InstallVSTemplates

/Out (devenv.exe)

Позволяет задавать файл для приема ошибок во время построения программы.

Devenv myproj.csproj /build /out log.txt

/Project (devenv.exe)

Проект, который требуется построить, очистить или развернуть. Данный переключатель может использоваться, только если указан переключатель /build, /rebuild, /clean или /deploy.

/ProjectConfig (devenv.exe)

Задает конфигурацию проекта, которую требуется построить или развернуть. Данный переключатель может использоваться, только если указан переключатель /project.

/Rebuild (devenv.exe)

Выполняет очистку, а затем построение указанного решения или проекта согласно конфигурации заданного решения.

/Upgrade (devenv.exe)

Обновляет заданный файл решения и все его файлы проекта или указанный файл проекта до текущих форматов Visual Studio для этих файлов.

/ResetSettings (devenv.exe)

Восстановление параметров Visual Studio по умолчанию. При необходимости выполняется сброс параметров в соответствии с указанным файлом .vssettings.

См. также

Ссылки

Страница "Общие", папка "Среда", диалоговое окно "Параметры"

Команды и переключатели Visual Studio