Przełączniki wiersza polecenia Devenv
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
devenvpliku rozwiązania polecenie przeszukuje folder nadrzędny pliku projektu dla pliku rozwiązania o tej samej nazwie. Na przykład poleceniedevenv myproject1.vbproj /buildwyszukuje folder nadrzędny dla pliku rozwiązania o nazwiemyproject1.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.txtspowoduje 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
devenvpoleceniach.
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 |