Compartilhar via


Arquivos MSBuild .targets

MSBuild inclui vários .targets arquivos que contêm itens, propriedades, destinos e tarefas para cenários comuns. Esses arquivos são automaticamente importados para a maioria dos arquivos de projeto do Visual Studio para simplificar a manutenção e a legibilidade.

Projetos no estilo SDK (projetos com algo como <Project Sdk="Microsoft.NET.Sdk">) importam .targets arquivos de forma diferente em comparação com projetos que não fazem referência a um SDK. Para projetos no estilo SDK, você não vê o arquivo importado .targets no arquivo de projeto, porque essas importações são gerenciadas pelo SDK que você referencia. No entanto, projetos de estilo SDK são equivalentes a projetos de estilo não-SDK com importações padrão antes e depois do corpo principal do arquivo, portanto, ainda é preciso dizer que os arquivos padrão .targets são importados nesses projetos.

Os destinos do SDK do .NET são instalados com o SDK do .NET, por exemplo, em C:\Program Files\dotnet\sdk\{version}\Sdks\Microsoft.NET.Sdk\targets\ para Microsoft.NET.Sdk no Windows. Para obter uma lista completa de SDKs e qual .targets arquivo eles importam, consulte SDKs de projeto .NET.

Projetos que não especificam um SDK geralmente importam explicitamente um ou mais .targets arquivos para definir seu processo de compilação. Por exemplo, projetos C# criados por versões anteriores do Visual Studio importam Microsoft.CSharp.targets, que importa Microsoft.Common.targets. O próprio projeto C# define os itens e propriedades específicos para esse projeto, mas as regras de compilação padrão para um projeto C# são definidas nos arquivos importados .targets .

O $(MSBuildToolsPath) valor especifica o caminho desses arquivos comuns .targets . Para projetos .NET, o caminho normalmente {Visual Studio installation folder}\MSBuild\Current\Bin\{architecture}é .

Observação

Para obter informações sobre como criar seus próprios destinos, consulte Destinos. Para obter informações sobre como usar o elemento Import para inserir um arquivo de projeto em outro arquivo de projeto, confira Elemento Import (MSBuild) e Como usar o mesmo destino em vários arquivos de projeto.

Arquivos comuns .targets

Arquivo .targets Descrição
Microsoft.Common.targets Define as etapas no processo de build padrão de projetos do C# e do Visual Basic.

Importado pelos arquivos Microsoft.CSharp.targets e Microsoft.VisualBasic.targets, que incluem a seguinte instrução: <Import Project="Microsoft.Common.targets" />
Microsoft.CSharp.targets Define as etapas no processo de build padrão de projetos do Visual C#.

Importado por arquivos de projeto Visual C# (.csproj).
Microsoft.VisualBasic.targets Define as etapas no processo de build padrão de projetos do Visual Basic.

Importado por arquivos de projeto do Visual Basic (.vbproj).

Se você abrir e exibir arquivos, verá que eles são wrappers bastante finos em torno de outros .targets arquivos, geralmente Microsoft.{language}.CurrentVersion.targets, ou para cenários de direcionamento cruzado, Microsoft.{language}.CrossTargeting.targets.

Directory.Build.targets

Directory.Build.targets é um arquivo definido pelo usuário que fornece personalizações a projetos em um diretório. Esse arquivo é importado automaticamente de Microsoft.Common.targets, a menos que a propriedade ImportDirectoryBuildTargets seja definida como false. Para obter mais informações, confira Personalizar seu build.

Confira também