Soubory NÁSTROJE MSBuild .targets

  • Článek

Nástroj MSBuild obsahuje několik .targets souborů, které obsahují položky, vlastnosti, cíle a úlohy pro běžné scénáře. Tyto soubory se automaticky naimportují do většiny souborů projektu sady Visual Studio, aby se zjednodušila údržba a čitelnost.

Projekty ve stylu sady SDK (projekty s podobnými <Project Sdk="Microsoft.NET.Sdk">typy) importuje .targets soubory odlišně než projekty, které neodkazuje na sadu SDK. U projektů ve stylu sady SDK se v souboru projektu nezobrazuje importovaný .targets soubor, protože tyto importy spravuje sada SDK, na kterou odkazujete. Projekty ve stylu sady SDK jsou však ekvivalentní projektům, které nejsou ve stylu sady SDK se standardními importy před a za hlavním tělem souboru, takže je stále přesné říci, že .targets standardní soubory se v těchto projektech importují.

Cíle sady .NET SDK se instalují například C:\Program Files\dotnet\sdk\{version}\Sdks\Microsoft.NET.Sdk\targets\ se sadou .NET SDK pro Microsoft.NET.Sdk Windows. Úplný seznam sad SDK a souborů, které .targets importují, najdete v tématu Sady SDK projektu .NET.

Projekty, které nezadávají sadu SDK, obvykle explicitně naimportují jeden nebo více .targets souborů pro definování procesu sestavení. Například projekty C# vytvořené staršími verzemi sady Visual Studio importují microsoft.CSharp.targets, které importují Microsoft.Common.targets. Samotný projekt jazyka C# definuje položky a vlastnosti specifické pro tento projekt, ale v importovaných .targets souborech jsou definována standardní pravidla sestavení pro projekt jazyka C#.

Hodnota $(MSBuildToolsPath) určuje cestu k těmto běžným .targets souborům. U projektů .NET je cesta obvykle {Visual Studio installation folder}\MSBuild\Current\Bin\{architecture}.

Poznámka:

Informace o tom, jak vytvořit vlastní cíle, najdete v tématu Cíle. Informace o tom, jak pomocí elementu Import vložit soubor projektu do jiného souboru projektu, naleznete v tématu Import element (MSBuild) a Postupy: Použití stejného cíle v několika souborech projektu.

Běžné .targets soubory

Soubor .targets Popis
Microsoft.Common.targets Definuje kroky ve standardním procesu sestavení pro projekty Jazyka Visual Basic a C#.

Importované soubory Microsoft.CSharp.targets a Microsoft.VisualBasic.targets , které zahrnují následující příkaz: <Import Project="Microsoft.Common.targets" />
Microsoft.CSharp.targets Definuje kroky ve standardním procesu sestavení pro projekty Visual C#.

Importované soubory projektu Visual C# (.csproj).
Microsoft.VisualBasic.targets Definuje kroky ve standardním procesu sestavení pro projekty jazyka Visual Basic.

Importované soubory projektu jazyka Visual Basic (.vbproj).

Pokud soubory otevřete a zobrazíte, uvidíte, že jsou poměrně tenké obálky kolem jiných .targets souborů, obvykle Microsoft.{language}.CurrentVersion.targetsnebo pro scénáře křížového cílení. Microsoft.{language}.CrossTargeting.targets

Directory.Build.targets

Directory.Build.targets je soubor definovaný uživatelem, který poskytuje vlastní nastavení projektů v adresáři. Tento soubor je automaticky importován z Microsoft.Common.targets , pokud vlastnost ImportDirectoryBuildTargets není nastavena na false. Další informace najdete v tématu Přizpůsobení sestavení.

Viz také