Udostępnij przez


Korzystanie z interfejsu API programu MSBuild

Program MSBuild udostępnia publiczną powierzchnię interfejsu API, dzięki czemu program może wykonywać kompilacje i sprawdzać projekty. Najnowsze wersje interfejsów API programu MSBuild można znaleźć w następujących pakietach NuGet:

Nazwa pakietu Opis
Microsoft.Build Zawiera zestaw Microsoft.Build, który służy do tworzenia, edytowania i oceniania projektów MSBuild.
Microsoft.Build.Framework Zawiera wspólny zestaw platformy MSBuild używany przez inne zestawy MSBuild.
Microsoft.Build.Runtime Dostarcza pełną kopię wykonywalną programu MSBuild. Odwołaj się do tego pakietu tylko wtedy, gdy aplikacja musi załadować projekty lub wykonać kompilacje w procesie bez konieczności instalowania programu MSBuild. Pomyślnie ocenianie projektów przy użyciu tego pakietu wymaga agregowania dodatkowych składników (takich jak kompilatory) w katalogu aplikacji.
Microsoft.Build.Tasks.Core Zawiera zestaw Microsoft.Build.Tasks, który implementuje często używane zadania programu MSBuild.
Microsoft.Build.Utilities.Core Zawiera zestaw Microsoft.Build.Utilities, który służy do implementowania niestandardowych zadań MSBuild.

Ponadto NuGet hostuje również starszy zestaw Microsoft.Build.Engine, który jest przestarzały.

Istnieje kilka różnych wersji interfejsu API MSBuild, a w wersjach 15 i 16 istnieją dwie odrębne formy zestawów w pakietach NuGet, jeden skompilowany przy użyciu programu .NET Framework, a drugi skompilowany za pomocą platformy .NET Core, który jest podzbiorem powierzchni interfejsu API programu .NET Framework. Wersja programu MSBuild platformy .NET Core jest używana podczas wywoływania dotnet polecenia oraz w przypadku korzystania z programu MSBuild w systemach Mac i Linux.

Dokumentację interfejsu API MSBuild można znaleźć przy użyciu przeglądarki interfejsu API platformy .NET lub przeglądając przestrzenie nazw na poniższej liście.

Namespace Ma zastosowanie do Opis
Microsoft.Build.Construction Wszystko Zawiera typy, które model obiektowy MSBuild wykorzystuje do konstruowania korzeni projektu z nieprzetworzonymi wartościami. Każdy katalog główny projektu odpowiada plikowi projektu lub plikowi docelowemu.
Microsoft.Build.Definition Wszystko Zawiera klasę ProjectOptions, która wspiera budowę projektu.
Microsoft.Build.Evaluation Wszystko Zawiera typy używane przez model obiektów MSBuild do oceny projektów. Każdy projekt jest skojarzony z co najmniej jednym katalogiem głównych projektów.
Microsoft.Build.Evaluation.Context Wszystko Zawiera klasę EvaluationContext, która jest używana do przechowywania stanu oceny między wywołaniami.
Microsoft.Build.Exceptions Wszystko Zawiera typy wyjątków, które mogą być zgłaszane podczas procesu kompilacji.
Microsoft.Build.Execution Wszystko Zawiera typy używane przez model obiektów MSBuild do kompilowania projektów.
Microsoft.Build.Framework Wszystko Typy obejmują sposoby, w jakie zadania i rejestratory współpracują z silnikiem MSBuild.
Microsoft.Build.Framework.Profiler Wszystko Zawiera typy, które obsługują profilowanie wydajności.
Microsoft.Build.Framework.XamlTypes Tylko program .NET Framework Zawiera klasy używane do reprezentowania typów XAML analizowanych z plików, reguł i innych źródeł.
Microsoft.Build.Globbing Wszystko Zawiera klasy obsługujące przetwarzanie symboli wieloznacznych.
Microsoft.Build.Globbing.Extensions Wszystko Zawiera typy, które obsługują rozszerzenia przetwarzania symboli wieloznacznych.
Microsoft.Build.Graph Wszystko Zawiera typy obsługujące -graph przełącznik MSBuild.
Microsoft.Build.Logging Wszystko Zawiera typy używane do rejestrowania postępu kompilacji.
Microsoft.Build.ObjectModelRemoting Wszystko Zawiera typy obsługujące komunikację zdalną w programie MSBuild.
Microsoft.Build.Tasks Wszystko Zawiera implementację wszystkich zadań dostarczanych z MSBuild.
Microsoft.Build.Tasks.Deployment.Bootstrapper Tylko program .NET Framework Zawiera klasy używane wewnętrznie przez program MSBuild.
Microsoft.Build.Tasks.Deployment.ManifestUtilities Tylko program .NET Framework Zawiera klasy używane przez program MSBuild.
Microsoft.Build.Tasks.Hosting Wszystko Zawiera klasy używane wewnętrznie przez program MSBuild.
Microsoft.Build.Tasks.Xaml Tylko program .NET Framework Zawiera klasy związane z zadaniami kompilacji XAML.
Microsoft.Build.Utilities Wszystko Zawiera klasy pomocnicze, których można użyć do tworzenia własnych rejestratorów i zadań MSBuild.

W poprzedniej tabeli Wszystkie w kolumnie Zastosuj do oznacza, że typy w przestrzeni nazw są dostępne zarówno w programie .NET Framework, jak i w wersjach .NET Core MSBuild API.

Lokalizator MSBuild

Lokalizator MSBuild to interfejs API, którego można użyć do znalezienia programu MSBuild na maszynie. Można go używać w programach tworzenia narzędzi kompilacji, gdy chcesz znaleźć zainstalowane wersje programu MSBuild.

Pakiet NuGetPackage znajduje się w witrynie Microsoft.Build.Locator , a dokumentacja referencyjna znajduje się w firmie Microsoft.

Aby uzyskać więcej informacji na temat programu MSBuildLocator, zobacz Znajdowanie i używanie wersji programu MSBuild.

  • MSBuild