/Build (devenv.exe)
Kompiluje rozwiązanie lub projekt przy użyciu określonego pliku konfiguracji rozwiązania.
Składnia
devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]
Argumenty
Nazwa rozwiązania
Wymagany. Ścieżka i nazwa pliku rozwiązania względem katalogu rozwiązania.
SolnConfigName
Opcjonalny. Nazwa konfiguracji rozwiązania (na przykład
Debug
lubRelease
) do utworzenia rozwiązania o nazwie w polu SolutionName. Jeśli dostępnych jest wiele platform rozwiązań, należy również określić platformę (na przykładDebug|Win32
). Jeśli ten argument jest nieokreślony lub pusty ciąg (""
), narzędzie używa aktywnej konfiguracji rozwiązania./Project
ProjNameOpcjonalny. Ścieżka i nazwa pliku projektu w rozwiązaniu. Możesz wprowadzić ścieżkę względną z folderu SolutionName do pliku projektu lub nazwę wyświetlaną projektu albo pełną ścieżkę i nazwę pliku projektu.
/ProjectConfig
ProjConfigNameOpcjonalny. Nazwa konfiguracji kompilacji projektu (na przykład
Debug
lubRelease
) do użycia podczas kompilowania nazwanego projektu. Jeśli jest dostępna więcej niż jedna platforma rozwiązania, musisz również określić platformę (na przykładDebug|Win32
). Jeśli ten przełącznik zostanie określony, zastąpi argument SolnConfigName ./Out
OutputFilenameOpcjonalny. Nazwa pliku, do którego chcesz wysłać dane wyjściowe narzędzia. Jeśli plik już istnieje, narzędzie dołącza dane wyjściowe na końcu pliku.
Uwagi
Przełącznik
/Build
wykonuje tę samą funkcję co polecenie menu Kompiluj rozwiązanie w zintegrowanym środowisku projektowym (IDE).Ujęć ciągi, które zawierają spacje w cudzysłowach podwójnych.
Podsumowanie informacji dotyczących kompilacji, w tym błędów, można wyświetlić w oknie polecenia lub w dowolnym pliku dziennika określonym za pomocą przełącznika
/Out
.Przełącznik
/Build
kompiluje tylko projekty, które uległy zmianie od ostatniej kompilacji. Aby skompilować wszystkie projekty w rozwiązaniu, użyj / rebuild zamiast tego.Jeśli zostanie wyświetlony komunikat o błędzie z komunikatem Nieprawidłowa konfiguracja projektu, upewnij się, że określono platformę rozwiązania lub platformę projektu (na przykład
Debug|Win32
).
Przykłady
Następujące polecenie kompiluje projekt CSharpWinApp
przy użyciu Debug
konfiguracji kompilacji projektu w programie MySolution
.
devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug
Aby wyczyścić wszystkie pliki kompilacji:
devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean
Tworzenie projektu instalacyjnego
Aby utworzyć instalator (.msi
plik), potrzebny jest projekt instalacyjny, który zawiera .vdproj
plik projektu, ale aby go skompilować, należy najpierw zastosować obejście, które ustawia określony klucz rejestru. W wierszu polecenia dla deweloperów programu Visual Studio uruchom plik wykonywalny DisableOutOfProcBuild.exe z folderu Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild. Bez tego obejścia może wystąpić błąd: ERROR: An error occurred while validating. HRESULT = '8000000A'
. Polecenie ma wpływ na bieżącego użytkownika, więc w przypadku scenariuszy agenta kompilacji należy uruchomić go z tego samego konta, które uruchamia kompilację. Aby uzyskać więcej informacji, zobacz plik README.txt w tym samym folderze.
Ponadto w programie Visual Studio możesz utworzyć nową konfigurację, na przykład Setup
, na Release
podstawie konfiguracji, a następnie wybrać projekt instalacyjny jako projekt do skompilowania. Domyślnie projekty instalacyjne nie są uwzględniane w konfiguracjach domyślnych Debug
i Release
. Po zdefiniowaniu Setup
konfiguracji następujące polecenia kompilują projekt WindowsFormsApp1
i skojarzony z nim projekt instalacyjny w celu wygenerowania .msi
pliku:
devenv WindowsFormsApp1.sln /build Setup
Jeśli rozwiązanie zostało już skompilowane przy użyciu konfiguracji wydania , to polecenie po prostu skompiluje projekt instalacyjny.