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

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

  • /ProjectProjName

    Opcjonalny. Ś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.

  • /ProjectConfigProjConfigName

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

  • /OutOutputFilename

    Opcjonalny. 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 CSharpWinAppprzy 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.

Zobacz też