Przełączniki wiersza polecenia Devenv
Devenv pozwala ustawiać różne opcje dla zintegrowanego środowiska projektowego (IDE) oraz kompilować, debugować i wdrażać projekty z wiersza polecenia.Używaj tych przełączników, aby uruchamiać IDE ze skryptu lub pliku .bat, na przykład ze skryptu z kompilacji nocnej, lub uruchamiać IDE w określonej konfiguracji.
[!UWAGA]
Dla zadań związanych z kompilacją, zaleca się obecnie, aby używać programu MSBuild zamiast devenv.Aby uzyskać więcej informacji, zobacz Informacje w wierszu polecenia programu MSBuild.
[!UWAGA]
Aby korzystać w przełączników /Setup (devenv.exe) i /InstallVSTemplates (devenv.exe), należy uruchomić Devenv jako administrator.
Składnia przełącznika Devenv
Domyślnie polecenia devenv przekazują przełączniki do narzędzia devenv.com.
Narzędzie devenv.com zapewnia dostarczanie danych wyjściowych przez standardowe strumienie systemowe, takie jak stdout i stderr oraz określa odpowiednie przekierowanie I/O podczas przechwytywania danych wyjściowych, na przykład do pliku .txt.Polecenia, które zamiast tego rozpoczynają się od devenv.exe mogą używać tych samych przełączników, ale wyślą je do programu devenv.exe, pomijając narzędzie devenv.com.
Zasady składni dla przełączników devenv przypominają te dla innych narzędzi wiersza polecenia systemu DOS.Następujące reguły składni obowiązują dla wszystkich przełączników devenv oraz ich argumentów:
Polecenia zaczynają się od devenv.
Przełączniki nie uwzględniają wielkości liter.
Określając rozwiązanie lub projekt, pierwszy argument to nazwa pliku rozwiązania lub pliku projektu, włącznie ze ścieżką do pliku.
Jeśli pierwszym argumentem jest plik, który nie jest rozwiązaniem lub projektem, plik ten zostanie otwarty w odpowiednim edytorze w ramach nowego wystąpienia IDE.
W przypadku podania nazwy pliku projektu zamiast nazwy pliku rozwiązania, polecenie devenv przeszuka folder nadrzędny pliku projektu, aby znaleźć plik rozwiązania o takiej samej nazwie.Na przykład polecenie devenv /build myproject1.vbproj przeszuka folder nadrzędny aby znaleźć plik rozwiązania o nazwie "myproject1.sln".
[!UWAGA]
W folderze nadrzędnym projektu powinien znajdować się jeden i tylko jeden plik rozwiązania, który odwołuje się do tego projektu.Jeśli folder nadrzędny nie zawiera pliku rozwiązania odwołującego się do tego projektu, lub jeśli folder nadrzędny zawiera co najmniej dwa pliki rozwiązania odwołujących się do niego, wówczas zostanie utworzony tymczasowy plik rozwiązania, który ma nazwę projektu i odwołuje się do niego.
Jeśli ścieżki plików i nazwy plików zawierają spacje, należy ująć je w podwójne znaki cudzysłowu ("").Na przykład "c:\project a\".
Wstaw jeden znak spacji między przełącznikami i argumentami w jednym wierszu.Na przykład polecenie devenv /log output.txt otwiera IDE i wysyła na wyjście wszystkie informacje dziennika dla tej sesji do pliku output.txt.
Nie można używać składni wzorca dopasowania w poleceniach devenv.
Przełączniki Devenv
Użyj następujących przełączników wiersza polecenia, aby wyświetlić IDE i wykonać opisane zadanie.
Przełącznik wiersza polecenia |
Opis |
|---|---|
Uruchamia IDE i wykonuje określone polecenie. |
|
Ładuje plik wykonywalny Visual C++ pod kontrolą debugera.Ten przełącznik nie jest dostępny dla plików wykonywalnych Visual Basic lub Visual C#.Aby uzyskać więcej informacji, zobacz Automatyczne uruchamianie procesu w debugerze. |
|
/LCID (devenv.exe) lub /l |
Ustawia domyślny język IDE.Jeśli określony język nie jest dołączony w instalacji programu Visual Studio, to ustawienie będzie ignorowane. |
Uruchamia Visual Studio i rejestruje wszystkie działania w pliku dziennika. |
|
/Run (devenv.exe) lub /r |
Kompiluje i uruchamia określone rozwiązanie. |
Kompiluje i uruchamia określone rozwiązanie, minimalizuje IDE w momencie uruchomienia rozwiązania i zamyka IDE po zakończeniu działania rozwiązania. |
|
Powoduje, że IDE używa zmiennych środowiskowych PATH, INCLUDE i LIB do kompilacji Visual C++ zamiast ustawień określonych w sekcji Katalogi VC++ dla opcji Projekty w oknie dialogowym Opcje.Aby uzyskać więcej informacji, zobacz Ustawianie ścieżki i zmiennych środowiskowych dla kompilacji z wiersza polecenia. |
|
Otwiera określone pliki w działającym wystąpieniu tej aplikacji.Jeśli nie ma uruchomionych wystąpień, uruchomione zostanie nowe wystąpienie z uproszczonym układem okna. |
|
Uruchamia wystąpienie Visual Studio IDE bez ładowania określonego dodatku. |
|
Uruchamia Visual Studio w trybie awaryjnym i ładuje tylko domyślne środowisko, usługi oraz wysłane wersje pakietów innych firm. |
|
Czyści wszystkie tagi SkipLoading, które zostały dodane do VSPackages przez użytkowników, którzy chcą uniknąć problemu z ładowaniem VSPackages. |
|
Wymusza scalenie przez Visual Studio metadanych zasobu, który opisuje menu, paski narzędzi i grupy poleceń z wszystkich dostępnych VSPackages. |
Użyj następujących przełączników wiersza polecenia do wykonania opisanego zadania.Te przełączniki wiersza polecenia nie wyświetlają IDE.
Przełącznik wiersza polecenia |
Opis |
|---|---|
Wyświetla pomoc dotyczącą przełączników devenv w Oknie wiersza polecenia. Devenv /? |
|
Kompiluje określone rozwiązanie lub projekt zgodnie z konfiguracją określonego rozwiązania. Devenv myproj.csproj /build |
|
Usuwa wszystkie pliki utworzone przez polecenie kompilacji, nie wpływając na pliki źródłowe. Devenv myproj.csproj /clean |
|
Kompiluje rozwiązanie wraz z plikami niezbędnymi do wdrożenia, zgodnie z konfiguracją rozwiązania. Devenv myproj.csproj /deploy |
|
Porównuje dwa pliki. Pobiera cztery parametry: SourceFile, TargetFile, SourceDisplayName(opcjonalnie),TargetDisplayName(opcjonalnie). |
|
Rejestruje projekt lub szablony elementów, które znajdują się w <VisualStudioInstallDir>\Common7\IDE\ProjectTemplates lub <VisualStudioInstallDir>\Common7\IDE\ItemTemplates, aby można było uzyskać do nich dostęp przez okna dialogowe Nowy projekt i Dodaj nowy element. Devenv /InstallVSTemplates |
|
Pozwala określić plik do zgłaszania błędów podczas kompilacji. Devenv myproj.csproj /build /out log.txt |
|
Projekt do kompilacji, czyszczenia lub wdrożenia.Tego przełącznika można użyć tylko wtedy, gdy wprowadzony jest przełącznik /build, /rebuild, /clean lub /deploy. |
|
Określa konfigurację projektu do skompilowania lub wdrożenia.Tego przełącznika można użyć tylko wtedy, gdy wprowadzony jest przełącznik /project. |
|
Czyści, a następnie kompiluje określone rozwiązanie lub projekt zgodnie z konfiguracją określonego rozwiązania. |
|
Uaktualnia określony plik rozwiązania i wszystkie jego pliki projektu lub określony plik projektu do bieżących Visual Studio formatów tych plików. |
|
Przywraca ustawienia domyślne programu Visual Studio.Opcjonalnie resetuje ustawienia do określonego pliku .vssettings. |