Параметры командной строки для 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 |