Directory.Build.Props变量在旧式csproj格式中无法生效

我尝试通过Directory.Build.Props统一配置不同类型项目的目标框架变量，配置代码如下：

<Project>
   <PropertyGroup>
       <!-- For SDK style c# projects -->
       <ApmTargetFramework>net481</ApmTargetFramework>
   </PropertyGroup>

   <PropertyGroup>
      <ApmTargetFrameworkVersion>v4.8.1</ApmTargetFrameworkVersion>
   </PropertyGroup>      
   
   <PropertyGroup>
       <!-- For APM multi-targeted projects-->
       <ApmMultiTargetFrameworks>net6.0;net481</ApmMultiTargetFrameworks>
   </PropertyGroup>
</Project>

在SDK风格项目中，以下两种变量引用方式均能正常生效：

<TargetFrameworks>$(ApmMultiTargetFrameworks)</TargetFrameworks>

以及

<TargetFramework>$(ApmTargetFramework)</TargetFramework>

但在旧式非SDK风格的CSProj文件中，使用$(ApmTargetFrameworkVersion)为<TargetFrameworkVersion>赋值时，变量会呈现空值，配置无法生效：

<TargetFrameworkVersion>$(ApmTargetFrameworkVersion)</TargetFrameworkVersion>

手动直接写入<TargetFrameworkVersion>v4.8.1</TargetFrameworkVersion>则能正常工作，仅通过变量引用时出现异常。

原因分析 #

旧式CSProj的构建流程与SDK风格项目存在差异：

• Directory.Build.Props的加载时机早于旧式项目中部分关键初始化逻辑，导致变量无法被正确解析
• 旧式项目对MSBuild属性的解析逻辑和SDK项目不同，直接引用跨文件属性可能不被识别

解决方法 #

1. 改用Directory.Build.targets配置

将针对旧式项目的属性移至Directory.Build.targets文件，该文件的加载时机晚于Directory.Build.Props，能确保变量在旧式项目构建流程中被正确读取：

<!-- Directory.Build.targets -->
<Project>
    <PropertyGroup>
        <ApmTargetFrameworkVersion>v4.8.1</ApmTargetFrameworkVersion>
    </PropertyGroup>
</Project>

2. 在旧式CSProj中显式导入属性文件

若必须使用Directory.Build.Props，可在旧式项目文件开头显式导入该文件，强制属性提前加载：

<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <!-- 显式导入Directory.Build.Props -->
    <Import Project="Directory.Build.Props" />
    <PropertyGroup>
        <TargetFrameworkVersion>$(ApmTargetFrameworkVersion)</TargetFrameworkVersion>
        <!-- 其他项目配置 -->
    </PropertyGroup>
    <!-- 剩余项目内容 -->
</Project>

3. 为属性添加兜底条件

在Directory.Build.Props中给属性添加条件判断，确保旧式项目能正确读取到默认值：

<PropertyGroup>
    <ApmTargetFrameworkVersion Condition=" '$(ApmTargetFrameworkVersion)' == '' ">v4.8.1</ApmTargetFrameworkVersion>
</PropertyGroup>

内容的提问来源于stack exchange，提问作者Derek