如何为共享类库针对不同引用项目设置不同.NET版本目标

1. 修改共享类库的项目配置（.csproj） #

首先让Models和Components类库支持同时编译为.NET Framework 4.0和4.8版本，直接编辑类库的.csproj文件：

<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- 保留原有其他配置 -->
  <PropertyGroup>
    <!-- 替换原单个TargetFramework为多目标框架 -->
    <TargetFrameworks>net40;net48</TargetFrameworks>
    <!-- 配置分框架输出目录，避免编译文件冲突 -->
    <OutputPath>bin\$(Configuration)\$(TargetFramework)</OutputPath>
    <IntermediateOutputPath>obj\$(Configuration)\$(TargetFramework)</IntermediateOutputPath>
  </PropertyGroup>
  <!-- 保留原有其他配置 -->
</Project>

保存后，类库会在编译时自动生成两个版本的dll，分别对应net40和net48目录。

2. 用预处理指令处理框架差异代码（若需） #

如果类库中存在仅在特定框架下可用的API，可通过MSBuild预定义的符号做分支处理：

#if NET48
// .NET Framework 4.8 专属逻辑，例如使用Task.Run等新增API
public async Task ProcessDataAsync()
{
    await Task.Run(() => { /* 4.8特有的实现 */ });
}
#elif NET40
// .NET Framework 4.0 兼容逻辑，例如用Thread模拟异步
public void ProcessDataAsync()
{
    new Thread(() => { /* 4.0兼容的实现 */ }).Start();
}
#endif

注：NET40、NET48是MSBuild内置的预定义符号，无需手动定义。

3. 配置客户端项目的类库引用 #

针对ClientUI（.NET 4.0） #

修改ClientUI的.csproj，确保引用指向类库的net40版本输出：

<Reference Include="Models, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null">
  <HintPath>..\Models\bin\$(Configuration)\net40\Models.dll</HintPath>
</Reference>
<Reference Include="Components, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null">
  <HintPath>..\Components\bin\$(Configuration)\net40\Components.dll</HintPath>
</Reference>

或者在Visual Studio中右键引用→添加引用，选中类库后，在属性窗口设置「特定版本」为True，并手动指定net40目录下的dll路径。

针对ServerUI（.NET 4.8） #

同理，修改ServerUI的.csproj，引用指向类库的net48版本输出：

<Reference Include="Models, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null">
  <HintPath>..\Models\bin\$(Configuration)\net48\Models.dll</HintPath>
</Reference>
<Reference Include="Components, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null">
  <HintPath>..\Components\bin\$(Configuration)\net48\Components.dll</HintPath>
</Reference>

4. 编译与验证 #

• 编译整个解决方案时，Models和Components会同时生成两个版本的dll；
• 单独编译ClientUI时，会自动绑定.NET 4.0版本的类库；编译ServerUI时绑定.NET 4.8版本；
• 分别运行两个项目，验证功能正常且无兼容性报错。

额外注意事项 #

• 若类库依赖NuGet包，需确保包同时支持.NET 4.0和4.8，可通过条件引用区分版本：

<ItemGroup Condition="'$(TargetFramework)' == 'net40'">
  <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
</ItemGroup>
<ItemGroup Condition="'$(TargetFramework)' == 'net48'">
  <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
</ItemGroup>

• 尽量避免在类库中引入仅单一框架支持的API，除非通过预处理指令做完整兼容，否则会导致其中一个版本编译失败。

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