当前位置：首页 > news >正文

笔记：Directory.Build.targets和Directory.Build.props的区别

news 2025/8/26 15:35:46

一、目的：分享Directory.Build.targets和Directory.Build.props的区别

Directory.Build.targets 和 Directory.Build.props 是 MSBuild 的两个功能，用于在特定目录及其子目录中的所有项目中应用共享的构建设置。它们的主要区别在于应用的时机和用途。

二、区别

Directory.Build.props

• 应用时机:

Directory.Build.props 文件中的配置会在项目文件（.csproj）中的配置之前应用。

• 用途:

通常用于定义全局属性和项，这些属性和项可以在项目文件中被覆盖。

Directory.Build.targets

• 应用时机:

Directory.Build.targets 文件中的配置会在项目文件（.csproj）中的配置之后应用。

• 用途:

通常用于定义全局目标和任务，这些目标和任务可以覆盖项目文件中的设置。

三、使用场景

• Directory.Build.props:

适用于需要在项目文件之前定义的全局属性和项。例如，设置默认的输出路径、目标框架等。

• Directory.Build.targets:

适用于需要在项目文件之后定义的全局目标和任务。例如，自定义构建目标、后处理任务等。

示例

以下是 Directory.Build.props 和 Directory.Build.targets 文件的示例，展示了它们的典型用法。

Directory.Build.props

<Project><PropertyGroup><!-- 定义全局属性 --><Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration><Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform><OutputPath>bin\$(Configuration)\</OutputPath><TargetFramework>net8.0</TargetFramework></PropertyGroup><ItemGroup><!-- 定义全局引用 --><PackageReference Include="Newtonsoft.Json" Version="13.0.1" /></ItemGroup>
</Project>

Directory.Build.targets

<Project><Target Name="CustomTarget" AfterTargets="Build"><!-- 自定义构建目标 --><Message Text="Custom target executed after build." Importance="high" /></Target>
</Project>

结合使用

在实际项目中，Directory.Build.props 和 Directory.Build.targets 通常结合使用，以便在不同的构建阶段应用不同的配置。

示例项目结构

/MySolution/Directory.Build.props/Directory.Build.targets/ProjectA/ProjectA.csproj/ProjectB/ProjectB.csproj

Directory.Build.props

<Project><PropertyGroup><OutputPath>..\bin\$(Configuration)\$(MSBuildProjectName)\</OutputPath><TargetFramework>net8.0</TargetFramework></PropertyGroup>
</Project>

Directory.Build.targets

<Project><Target Name="AfterBuild" AfterTargets="Build"><Message Text="Custom task executed after build." Importance="high" /></Target>
</Project>

四、总结

•   Directory.Build.props: 在项目文件之前应用，适用于定义全局属性和项。
•   Directory.Build.targets: 在项目文件之后应用，适用于定义全局目标和任务。
        通过结合使用 Directory.Build.props 和 Directory.Build.targets，您可以在不同的构建阶段应用不同的配置，从而更好地管理和复用构建设置。