Program MSBuild w wierszu polecenia — C++

Ogólnie rzecz biorąc, zalecamy używanie programu Visual Studio do ustawiania właściwości projektu i wywoływania systemu MSBuild. Można jednak użyć narzędzia MSBuild bezpośrednio z poziomu wiersza polecenia. Proces kompilacji jest kontrolowany przez informacje w pliku projektu (vcxproj), który można utworzyć i edytować. Plik projektu określa opcje kompilacji na podstawie etapów kompilacji, warunków i zdarzeń. Ponadto można określić zero lub więcej argumentów opcji wiersza polecenia.

msbuild.exe [ project_file ] [ opcje ]

Użyj opcji wiersza polecenia /target (lub /t) i /property (lub /p), aby zastąpić określone właściwości i elementy docelowe określone w pliku projektu.

Podstawową funkcją pliku projektu jest określenie obiektu docelowego, który jest konkretną operacją zastosowaną do projektu, oraz danymi wejściowymi i wyjściowymi wymaganymi do wykonania tej operacji. Plik projektu może określać co najmniej jeden element docelowy, który może zawierać domyślny element docelowy.

Każdy element docelowy składa się z sekwencji co najmniej jednego zadania. Każde zadanie jest reprezentowane przez klasę .NET Framework zawierającą jedno polecenie wykonywalne. Na przykład zadanie CL zawiera polecenie cl.exe.

Parametr zadania jest właściwością zadania klasy i zazwyczaj reprezentuje opcję wiersza polecenia polecenia wykonywalnego. Na przykład FavorSizeOrSpeed parametr zadania odpowiada /Os i /Ot opcji kompilatoraCL.

Dodatkowe parametry zadania obsługują infrastrukturę MSBuild. Na przykład Sources parametr zadania określa zestaw zadań, które mogą być używane przez inne zadania. Aby uzyskać więcej informacji o zadaniach programu MSBuild, zobacz Informacje o zadaniach.

Większość zadań wymaga danych wejściowych i wyjściowych, takich jak nazwy plików, ścieżki i ciąg, numeryczne lub parametry logiczne. Na przykład typowe dane wejściowe to nazwa pliku źródłowego cpp do skompilowania. Ważnym parametrem wejściowym jest ciąg określający konfigurację kompilacji i platformę, na przykład "Debuguj|Win32". Dane wejściowe i wyjściowe są określane przez co najmniej jeden element XML Item zdefiniowany przez użytkownika zawarty w elemecie ItemGroup .

Plik projektu może również określać właściwości i ItemDefinitionGroupelementy zdefiniowane przez użytkownika. Pary nazw/wartości formularza właściwości i elementów, które mogą być używane jako zmienne w kompilacji. Składnik nazwy pary definiuje makro, a składnik wartości deklaruje wartość makra. Dostęp do makra właściwości uzyskuje się przy użyciu notacji $(name), a dostęp do makra elementu jest uzyskiwany przy użyciu notacji %(name).

Inne elementy XML w pliku projektu mogą testować makra, a następnie warunkowo ustawiać wartość dowolnego makra lub kontrolować wykonywanie kompilacji. Nazwy makr i ciągi literału można połączyć w celu wygenerowania konstrukcji, takich jak ścieżka i nazwa pliku. W wierszu polecenia /property ustawia lub zastępuje właściwość projektu. Nie można odwoływać się do elementów w wierszu polecenia.

System MSBuild może warunkowo wykonać element docelowy przed innym obiektem docelowym lub po nim. Ponadto system może utworzyć obiekt docelowy na podstawie tego, czy pliki używane przez obiekt docelowy są nowsze niż pliki emitowane.

Aby uzyskać więcej informacji na temat programu MSBuild, zobacz:

• MsBuild — omówienie pojęć dotyczących programu MSBuild .

• Informacje referencyjne programu MSBuild dotyczące systemu MSBuild.

• Dokumentacja schematu pliku projektu zawiera listę elementów schematu XML programu MSBuild wraz z ich atrybutami oraz elementami nadrzędnymi i podrzędnymi. Zwróć szczególnie uwagę na elementy ItemGroup, PropertyGroup, Target i Task.

• Dokumentacja wiersza polecenia opisuje argumenty wiersza polecenia i opcje, których można używać z msbuild.exe.

• Dokumentacja zadania opisuje zadania programu MSBuild. Szczególnie należy pamiętać o tych zadaniach, które są specyficzne dla języka Visual C++: BscMake Task, CL Task, CPPClean Task, LIB Task, Link Task, MIDL Task, MT Task, RC Task, SetEnv Task, VCMessage Task

W tej sekcji

Okres	Definicja
Przewodnik: tworzenie projektu C++ przy użyciu programu MSBuild	Pokazuje, jak utworzyć projekt programu Visual Studio C++ przy użyciu programu MSBuild.
Instrukcje: korzystanie ze zdarzeń kompilacji w projektach MSBuild	Demonstruje sposób określania akcji, która występuje na etapie partykulatora w kompilacji: przed rozpoczęciem kompilacji; przed rozpoczęciem kroku łącza; lub po zakończeniu kompilacji.
Instrukcje: dodawanie niestandardowego kroku kompilacji do projektów MSBuild	Przedstawia sposób dodawania etapu zdefiniowanego przez użytkownika do sekwencji kompilacji.
Instrukcje: dodawanie niestandardowych narzędzi kompilacji do projektów MSBuild	Pokazuje, jak skojarzyć narzędzie kompilacji z określonym plikiem.
Instrukcje: integrowanie narzędzi niestandardowych we właściwościach projektu	Przedstawia sposób dodawania opcji dla niestandardowego narzędzia do właściwości projektu.
Instrukcje: modyfikowanie platformy docelowej i zestawu narzędzi platformy	Przedstawia sposób kompilowania projektu dla wielu struktur lub zestawów narzędzi.

Zobacz też

Używanie zestawu narzędzi MSVC z poziomu wiersza polecenia