/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
SolutionName
Wymagane. Ścieżka i nazwa pliku rozwiązania względem katalogu rozwiązania.
SolnConfigName
Fakultatywny. Nazwa konfiguracji rozwiązania (na przykład
Debug
lubRelease
) do utworzenia rozwiązania o nazwie w 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
ProjNameFakultatywny. Ścieżka i nazwa pliku projektu w rozwiązaniu. Możesz wprowadzić ścieżkę względną z folderu SolutionName do pliku projektu lub nazwy wyświetlanej projektu albo pełnej ścieżki i nazwy pliku projektu.
/ProjectConfig
ProjConfigNameFakultatywny. Nazwa konfiguracji kompilacji projektu (na przykład
Debug
lubRelease
), która ma być używana 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
OutputFilenameFakultatywny. 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 Build Solution 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 konfiguracji kompilacji projektu Debug
w 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 (plik.msi
), potrzebujesz projektu instalacyjnego, który ma plik projektu .vdproj
, 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żna utworzyć nową konfigurację , np. Setup
, na podstawie konfiguracji Release
i wybrać projekt instalacyjny jako projekt do skompilowania. Domyślnie projekty instalacyjne nie są uwzględniane w domyślnych konfiguracjach, Debug
i Release
. Po zdefiniowaniu konfiguracji Setup
następujące polecenia kompilują projekt WindowsFormsApp1
i skojarzony z nim projekt instalacyjny w celu wygenerowania pliku .msi
:
devenv WindowsFormsApp1.sln /build Setup
Jeśli rozwiązanie zostało już skompilowane przy użyciu konfiguracji Release, to polecenie kompiluje tylko projekt instalacyjny.
Zobacz też
- kompilowanie i czyszczenie projektów i rozwiązań
- przełączniki wiersza polecenia Devenv
- /Rebuild (devenv.exe)
- /Clean (devenv.exe)
- /Out (devenv.exe)