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

  • Статья

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

Примечание.

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

Сведения о параметрах, предназначенных в основном для разработки расширений Visual Studio, см. в разделе "Коммутаторы командной строки Devenv" для разработки VSPackage.

Синтаксис параметров команды devenv

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

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

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

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

  • Параметры обрабатываются без учета регистра.

  • Параметр можно указать с помощью дефиса (-) или косой черты (/).

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

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

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

    Примечание.

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

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

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

  • В командах devenv нельзя использовать синтаксис сопоставления шаблонов.

Параметры команды devenv

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

Параметр командной строки Description
/Command Запускает среду IDE и выполняет указанную команду.

devenv /command "nav https://learn.microsoft.com/"
/DebugExe Загружает исполняемый файл C++ под управлением отладчика. Этот параметр недоступен для исполняемых файлов Visual Basic или C#. Дополнительные сведения см. в разделе Автоматический запуск процесса в отладчике.

devenv /debugexe mysln.exe
/Diff Сравнение двух файлов. Принимает четыре параметра: SourceFile, TargetFile, SourceDisplayName (необязательно) и TargetDisplayName (необязательно).

devenv /diff File1 File2 Alias1 Alias2
/DoNotLoadProjects Открывает указанное решение без загрузки каких-либо проектов.

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

devenv /edit File1 File2
/LCID или /L Задает язык по умолчанию для среды IDE. Если указанный язык не включен в пакет установки Visual Studio, этот параметр игнорируется.

devenv /l 1033
/Log Запускает Visual Studio и записывает все действия в файл журнала.

devenv /log mylogfile.xml
/NoScale Открывает интегрированную среду разработки в отключенном DPI режиме , который позволяет более точно использовать макет в конструкторе Windows Forms.
/NoSplash Открывает интегрированную среду разработки без отображения экрана-заставки.

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

devenv /resetsettings mysettings.vssettings
/Run или /R Компилирует и запускает указанное решение.

devenv /run mysln.sln
/RunExit Компилирует и выполняет указанное решение, свертывая окно IDE при выполнении решения и закрывая IDE после завершения выполнения.

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

У этого параметра нет аргументов.
/TfsLink Открывает Team Explorer и запускает средство просмотра для URI артефакта, если он зарегистрирован.
/UseEnv Инициирует использование в интегрированной среде разработки переменных среды PATH, INCLUDE, LIBPATH и LIB для компиляции на C++. Параметр устанавливается с рабочей нагрузкой Разработка классических приложений на C++. Дополнительные сведения см. в статье Установка переменных пути и среды при построении из командной строки.

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

Параметр командной строки Description
/? Отображает справку по параметрам devenv в окне командной строки.

У этого параметра нет аргументов.
/Build Выполняет сборку указанного решения или проекта согласно конфигурации заданного решения.

devenv mysln.sln /build
/Clean Удаляет все файлы, созданные командой сборки, не затрагивая исходные файлы.

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

devenv mysln.sln /deploy
/Out Позволяет указать файл для приема ошибок во время сборки.

devenv mysln.sln /build Debug /out log.txt
/Project Проект, который требуется собрать, очистить или развернуть. Этот параметр можно использовать, только если был указан параметр /Build, /Rebuild, /Clean или /Deploy.

devenv mysln.sln /build Debug /project proj1
/ProjectConfig Задает конфигурацию проекта, которую требуется собрать или развернуть. Этот параметр можно использовать, только если был указан параметр /Project.

devenv mysln.sln /build Release /project proj1 /projectconfig Release
/Rebuild Выполняет очистку, а затем сборку указанного решения или проекта согласно конфигурации заданного решения.

devenv mysln.sln /rebuild
/Setup Позволяет Visual Studio объединить метаданные ресурсов, описывающие меню, панели инструментов и группы команд из всех доступных VSPackages. Эту команду можно выполнить только от имени администратора.
/Upgrade Обновляет указанный файл решения и все его файлы проектов либо указанный файл проекта до текущих форматов Visual Studio для этих файлов.

devenv mysln.sln /upgrade

См. также