Przełączniki wiersza polecenia Devenv

  • Artykuł

Narzędzie Devenv umożliwia ustawianie różnych opcji dla środowiska IDE, projektów kompilacji, projektów debugowania i wdrażania projektów z poziomu wiersza polecenia. Użyj tych przełączników, aby uruchomić środowisko IDE ze skryptu lub pliku bat (takiego jak nocny skrypt kompilacji) lub uruchomić środowisko IDE w określonej konfiguracji.

Uwaga

W przypadku zadań związanych z kompilacją zaleca się używanie programu MSBuild zamiast devenv. Aby uzyskać więcej informacji, zobacz dokumentacja wiersza polecenia programu MSBuild.

Aby uzyskać informacje o przełącznikach przeznaczonych głównie do opracowywania rozszerzeń programu Visual Studio, zobacz Również Devenv command-line switchs for VSPackage development (Przełączniki wiersza polecenia devenv na potrzeby opracowywania pakietów VSPackage).

Składnia przełącznika Devenv

Polecenia rozpoczynające się od devenv są obsługiwane przez devenv.com narzędzie, które dostarcza dane wyjściowe za pośrednictwem standardowych strumieni systemu, takich jak stdout i stderr. Narzędzie określa odpowiednie przekierowanie we/wy podczas przechwytywania danych wyjściowych, na przykład do pliku txt.

Alternatywnie polecenia rozpoczynające się od devenv.exe polecenia mogą używać tych samych przełączników, ale devenv.com narzędzie jest pomijane. Użycie devenv.exe bezpośrednio uniemożliwia wyświetlenie danych wyjściowych w konsoli programu .

Reguły składni przełączników devenv przypominają reguły dla innych narzędzi wiersza polecenia systemu DOS. Następujące reguły składni dotyczą wszystkich devenv przełączników i ich argumentów:

  • Polecenia zaczynają się od devenv.

  • Przełączniki nie są uwzględniane wielkości liter.

  • Przełącznik można określić za pomocą łącznika ("-") lub ukośnika do przodu ("/").

  • Podczas określania rozwiązania lub projektu pierwszy argument to nazwa pliku rozwiązania lub pliku projektu, w tym ścieżka pliku.

  • Jeśli pierwszym argumentem jest plik, który nie jest rozwiązaniem lub projektem, ten plik zostanie otwarty w odpowiednim edytorze, w nowym wystąpieniu środowiska IDE.

  • Po podaniu nazwy pliku projektu zamiast nazwy devenv pliku rozwiązania polecenie przeszukuje folder nadrzędny pliku projektu dla pliku rozwiązania o tej samej nazwie. Na przykład polecenie devenv myproject1.vbproj /build wyszukuje folder nadrzędny dla pliku rozwiązania o nazwie myproject1.sln.

    Uwaga

    Jeden i tylko jeden plik rozwiązania, który odwołuje się do tego projektu, powinien znajdować się w folderze nadrzędnym. Jeśli folder nadrzędny nie zawiera pliku rozwiązania, który odwołuje się do tego projektu, lub jeśli folder nadrzędny zawiera co najmniej dwa pliki rozwiązania odwołujące się do niego, zostanie utworzony tymczasowy plik rozwiązania.

  • Gdy ścieżki plików i nazwy plików zawierają spacje, należy je ująć w znaki cudzysłowu (""). Na przykład "c:\project a\".

  • Wstaw jeden znak odstępu między przełącznikami i argumentami w tym samym wierszu. Na przykład polecenie devenv /log output.txt spowoduje otwarcie środowiska IDE i wyprowadzenie wszystkich informacji dziennika dla tej sesji do pliku output.txt.

  • Nie można używać składni dopasowywania wzorców w devenv poleceniach.

Przełączniki devenv

Następujące przełączniki wiersza polecenia wyświetlają środowisko IDE i wykonują opisane zadanie.

Przełącznik wiersza polecenia opis
/Command Uruchamia środowisko IDE i wykonuje określone polecenie.

devenv /command "nav https://learn.microsoft.com/"
/DebugExe Ładuje plik wykonywalny języka C++ pod kontrolą debugera. Ten przełącznik nie jest dostępny dla plików wykonywalnych języka Visual Basic ani C#. Aby uzyskać więcej informacji, zobacz Automatyczne uruchamianie procesu w debugerze.

devenv /debugexe mysln.exe
/Diff Porównuje dwa pliki. Przyjmuje cztery parametry: SourceFile, TargetFile, SourceDisplayName (opcjonalnie) i TargetDisplayName (opcjonalnie).

devenv /diff File1 File2 Alias1 Alias2
/DoNotLoadProjects Otwiera określone rozwiązanie bez ładowania żadnych projektów.

devenv /donotloadprojects mysln.sln
/Edit Otwiera określone pliki w uruchomionym wystąpieniu tej aplikacji. Jeśli nie ma uruchomionych wystąpień, uruchamia nowe wystąpienie z uproszczonym układem okna.

devenv /edit File1 File2
/LCID lub /L Ustawia język domyślny dla środowiska IDE. Jeśli określony język nie jest uwzględniony w instalacji programu Visual Studio, to ustawienie jest ignorowane.

devenv /l 1033
/Log Uruchamia program Visual Studio i rejestruje wszystkie działania w pliku dziennika.

devenv /log mylogfile.xml
/NoScale Otwiera środowisko IDE w trybie wyłączonym DPI, który umożliwia bardziej dokładny układ w Projektant formularzy systemu Windows.
/NoSplash Otwiera środowisko IDE bez wyświetlania ekranu powitalnego.

devenv /nosplash File1 File2
/ResetSettings Przywraca domyślne ustawienia programu Visual Studio. Opcjonalnie resetuje ustawienia do określonego .vssettings pliku.

devenv /resetsettings mysettings.vssettings
/Uruchom lub /R Kompiluje i uruchamia określone rozwiązanie.

devenv /run mysln.sln
/RunExit Kompiluje i uruchamia określone rozwiązanie, minimalizuje środowisko IDE po uruchomieniu rozwiązania i zamyka środowisko IDE po zakończeniu działania rozwiązania.

devenv /runexit mysln.sln
/SafeMode Uruchamia program Visual Studio w trybie awaryjnym. Ten przełącznik ładuje tylko środowisko domyślne, usługi domyślne i dostarczane wersje pakietów innych firm.

Ten przełącznik nie przyjmuje żadnych argumentów.
/TfsLink Otwiera program Team Explorer i uruchamia przeglądarkę dla podanego identyfikatora URI artefaktu, jeśli został zarejestrowany.
/UseEnv Powoduje, że środowisko IDE używa zmiennych środowiskowych PATH, INCLUDE, LIBPATH i LIB na potrzeby kompilacji języka C++. Ten przełącznik jest instalowany z pakietem roboczym Programowanie aplikacji klasycznych w języku C++ . Aby uzyskać więcej informacji, zobacz Ustawianie ścieżki i zmiennych środowiskowych dla kompilacji wiersza polecenia.

Następujące przełączniki wiersza polecenia nie wyświetlają środowiska IDE.

Przełącznik wiersza polecenia opis
/? Wyświetla pomoc dotyczącą devenv przełączników w oknie wiersza polecenia.

Ten przełącznik nie przyjmuje żadnych argumentów.
/Build Kompiluje określone rozwiązanie lub projekt zgodnie z konfiguracją określonego rozwiązania.

devenv mysln.sln /build
/Clean Usuwa wszystkie pliki utworzone przez polecenie kompilacji bez wpływu na pliki źródłowe.

devenv mysln.sln /clean
/Deploy Kompiluje rozwiązanie wraz z plikami niezbędnymi do wdrożenia zgodnie z konfiguracją rozwiązania.

devenv mysln.sln /deploy
/Out Umożliwia określenie pliku, który będzie otrzymywać błędy podczas kompilacji.

devenv mysln.sln /build Debug /out log.txt
/Project Projekt do kompilowania, czyszczenia lub wdrażania. Tego przełącznika można użyć tylko wtedy, gdy podano /Buildrównież przełącznik , /Rebuild, /Cleanlub /Deploy .

devenv mysln.sln /build Debug /project proj1
/ProjectConfig Określa konfigurację projektu do kompilowania lub wdrażania. Tego przełącznika /Project można użyć tylko wtedy, gdy został również dostarczony przełącznik.

devenv mysln.sln /build Release /project proj1 /projectconfig Release
/Rebuild Czyści, a następnie kompiluje określone rozwiązanie lub projekt zgodnie z konfiguracją określonego rozwiązania.

devenv mysln.sln /rebuild
/Setup Wymusza scalanie metadanych zasobów w programie Visual Studio, które opisują menu, paski narzędzi i grupy poleceń ze wszystkich dostępnych pakietów VSPackage. To polecenie można uruchomić tylko jako administrator.
/Upgrade Uaktualnia określony plik rozwiązania i wszystkie jego pliki projektu lub określony plik projektu do bieżących formatów programu Visual Studio dla tych plików.

devenv mysln.sln /upgrade

Zobacz też