Archivos de MSBuild .targets

  • Artículo

MSBuild incluye varios .targets archivos que contienen elementos, propiedades, destinos y tareas para escenarios comunes. Estos archivos se importan automáticamente en la mayoría de los archivos del proyecto de Visual Studio para simplificar el mantenimiento y la legibilidad.

Los proyectos de estilo SDK (proyectos con algo parecido <Project Sdk="Microsoft.NET.Sdk">a ) importan .targets archivos de forma diferente en comparación con los proyectos que no hacen referencia a un SDK. En el caso de los proyectos de estilo SDK, no ve el archivo importado .targets en el archivo de proyecto, ya que esas importaciones se administran mediante el SDK al que hace referencia. Sin embargo, los proyectos de estilo SDK son equivalentes a proyectos que no son de estilo SDK con importaciones estándar antes y después del cuerpo principal del archivo, por lo que sigue siendo preciso decir que los archivos estándar .targets se importan en esos proyectos.

Los destinos del SDK de .NET se instalan con el SDK de .NET, por ejemplo, en C:\Program Files\dotnet\sdk\{version}\Sdks\Microsoft.NET.Sdk\targets\ para Microsoft.NET.Sdk en En Windows. Para obtener una lista completa de los SDK y el .targets archivo que importan, consulte SDK de proyectos de .NET.

Los proyectos que no especifican un SDK suelen importar explícitamente uno o varios .targets archivos para definir su proceso de compilación. Por ejemplo, los proyectos de C# creados por versiones anteriores de Visual Studio importan Microsoft.CSharp.targets, que importa Microsoft.Common.targets. El propio proyecto de C# define los elementos y propiedades específicos de ese proyecto, pero las reglas de compilación estándar para un proyecto de C# se definen en los archivos importados .targets .

El $(MSBuildToolsPath) valor especifica la ruta de acceso de estos archivos comunes .targets . En el caso de los proyectos de .NET, la ruta de acceso suele ser {Visual Studio installation folder}\MSBuild\Current\Bin\{architecture}.

Nota:

Para obtener información sobre cómo crear sus propios destinos, consulte Destinos. Para obtener información sobre cómo usar el elemento Import para insertar un archivo de proyecto en otro, vea Elemento Import (MSBuild) y Cómo: Usar el mismo destino en varios archivos de proyecto.

Archivos comunes .targets

Archivo .targets Descripción
Microsoft.Common.targets Define los pasos en el proceso de compilación estándar para proyectos de Visual Basic y C#.

Importado por los archivos Microsoft.CSharp.targets y Microsoft.VisualBasic.targets, que incluyen la siguiente instrucción: <Import Project="Microsoft.Common.targets" />
Microsoft.CSharp.targets Define los pasos en el proceso de compilación estándar para proyectos de Visual C#.

Importado por archivos de proyecto de Visual C# (.csproj).
Microsoft.VisualBasic.targets Define los pasos en el proceso de compilación estándar para proyectos de Visual Basic.

Importado por archivos de proyecto de Visual Basic (.vbproj).

Si abre y ve archivos, verá que son contenedores finos alrededor de otros .targets archivos, normalmente Microsoft.{language}.CurrentVersion.targets, o para escenarios de destino cruzado, Microsoft.{language}.CrossTargeting.targets.

Directory.Build.targets

Directory.Build.targets es un archivo definido por el usuario que proporciona personalizaciones a proyectos de un directorio. Este archivo se importa automáticamente desde Microsoft.Common.targets, a menos que la propiedad ImportDirectoryBuildTargets esté establecida en false. Para más información, personalice su compilación.

Vea también