Udostępnij za pośrednictwem


/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 lub Release) 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ład Debug|Win32). Jeśli ten argument jest nieokreślony lub pusty ciąg (""), narzędzie używa aktywnej konfiguracji rozwiązania.

  • /Project ProjName

    Fakultatywny. Ś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 ProjConfigName

    Fakultatywny. Nazwa konfiguracji kompilacji projektu (na przykład Debug lub Release), 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ład Debug|Win32). Jeśli ten przełącznik zostanie określony, zastąpi argument SolnConfigName.

  • /Out OutputFilename

    Fakultatywny. 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 CSharpWinAppprzy 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ż