Pliki MSBuild .targets

  • Artykuł

Program MSBuild zawiera kilka .targets plików, które zawierają elementy, właściwości, obiekty docelowe i zadania dla typowych scenariuszy. Te pliki są automatycznie importowane do większości plików projektu programu Visual Studio, aby uprościć konserwację i czytelność.

Projekty w stylu zestawu SDK (projekty z czymś takim jak <Project Sdk="Microsoft.NET.Sdk">) importują .targets pliki inaczej niż projekty, które nie odwołują się do zestawu SDK. W przypadku projektów w stylu zestawu SDK nie widać zaimportowanych .targets plików w pliku projektu, ponieważ te importy są zarządzane przez zestaw SDK, do którego się odwołujesz. Jednak projekty w stylu zestawu SDK są równoważne projektom w stylu innych niż zestaw SDK ze standardowymi importami przed i po głównej treści pliku, dlatego nadal dokładne jest stwierdzenie, że standardowe .targets pliki są importowane w tych projektach.

Elementy docelowe zestawu .NET SDK są instalowane z zestawem .NET SDK, na przykład w C:\Program Files\dotnet\sdk\{version}\Sdks\Microsoft.NET.Sdk\targets\ lokalizacji dla Microsoft.NET.Sdk systemu Windows. Aby uzyskać pełną listę zestawów SDK i importowanych .targets plików, zobacz Zestawy SDK projektu platformy .NET.

Projekty, które nie określają zestawu SDK, zwykle jawnie importują jeden lub więcej .targets plików w celu zdefiniowania procesu kompilacji. Na przykład projekty języka C# utworzone we wcześniejszych wersjach programu Visual Studio importuje obiekty Microsoft.CSharp.targets, które importuje obiekty Microsoft.Common.targets. Sam projekt języka C# definiuje elementy i właściwości specyficzne dla tego projektu, ale standardowe reguły kompilacji dla projektu języka C# są zdefiniowane w zaimportowanych .targets plikach.

Wartość $(MSBuildToolsPath) określa ścieżkę tych typowych .targets plików. W przypadku projektów platformy .NET ścieżka jest zwykle następująca {Visual Studio installation folder}\MSBuild\Current\Bin\{architecture}: .

Uwaga

Aby uzyskać informacje na temat tworzenia własnych obiektów docelowych, zobacz Cele. Aby uzyskać informacje na temat sposobu użycia Import elementu w celu wstawienia pliku projektu do innego pliku projektu, zobacz Import element (MSBuild) i How to: Use the same target in multiple project files (Importowanie elementu (MSBuild) i How to: Use the same target in multiple project files (Jak używać tego samego obiektu docelowego w wielu plikach projektu).

Typowe .targets pliki

Plik targets opis
Microsoft.common.targets Definiuje kroki w standardowym procesie kompilacji dla projektów Visual Basic i C#.

Zaimportowane przez pliki Microsoft.CSharp.targets i Microsoft.VisualBasic.targets , które zawierają następującą instrukcję: <Import Project="Microsoft.Common.targets" />
Microsoft.CSharp.targets Definiuje kroki w standardowym procesie kompilacji dla projektów Visual C#.

Zaimportowane przez pliki projektu Visual C# (.csproj).
Microsoft.VisualBasic.targets Definiuje kroki w standardowym procesie kompilacji dla projektów Visual Basic.

Zaimportowane przez pliki projektu Visual Basic (.vbproj).

Jeśli otwierasz i wyświetlasz pliki, zobaczysz, że są one raczej cienkimi otokami wokół innych .targets plików, zwykle Microsoft.{language}.CurrentVersion.targets, lub w scenariuszach obejmujących wiele elementów docelowych, Microsoft.{language}.CrossTargeting.targets.

Directory.Build.targets

Directory.Build.targets to plik zdefiniowany przez użytkownika, który zapewnia dostosowania projektów w katalogu. Ten plik jest automatycznie importowany z obiektów Microsoft.Common.targets , chyba że właściwość ImportDirectoryBuildTargets ma wartość false. Aby uzyskać więcej informacji, dostosuj kompilację.

Zobacz też