zoukankan      html  css  js  c++  java
  • 让一个 csproj 项目指定多个开发框架

    可移植类库、共享项目、.NET Standard 项目都能够帮我们完成跨多个 .NET SDK 的单一项目开发,但它们的跨 SDK 开发都有些限制。现在,我们又有新的方式能够跨多个 .NET SDK 开发了,这就是使用新的 csproj 文件格式。


    看看拥有多个开发框架的项目长什么样吧!

    多 SDK 的项目
    ▲ 多 SDK 项目

    是不是很激动?

     

    新 csproj 文件

    如何组织一个同时面向 UWP/WPF/.Net Core 控制台的 C# 项目解决方案 - walterlv 一文中我讲了 .NET Standard 的方式,这种方式优势非常明显,跟普通的开发方式一样,也是我最推荐的方式。但缺点是要求目标 SDK 支持对应的 .NET Standard 版本。

    使用共享项目的方式则是直接共享了源码,只要在目标项目中指定了条件编译符,那么源码便能针对各种不同的目标框架进行分别编译。但缺点是对扩展插件的支持较差(可能是因为扩展插件难以判断项目的真实开发框架),而且 Visual Studio 本身对它的支持也有 BUG(例如切换编写文件所属的项目经常会失败)。

    新的 csproj 文件能够指定多个开发框架。这样,我们便能同时编写适用于 .NET Framework 4.5 的和 .NET Standard 2.0 的代码,同时还能够得到 Visual Studio 和扩展插件较好的支持。

    .NET Standard 和 .NET Core 项目在创建之时就已经是新的 csproj 格式了,但 .NET Framework 项目、UWP/WPF 项目依然使用旧风格的 csproj 文件。对于 .NET Framework 项目,可以通过 将 WPF、UWP 以及其他各种类型的旧样式的 csproj 文件迁移成新样式的 csproj 文件 - walterlv 一文进行迁移。不过对于 WPF/UWP 项目,根本就没有跨多个 SDK 的必要,就不要改了……

    如果是新开项目——强烈建议先按照 .NET Standard 项目类型建好,再修改成多开发框架。

    如何指定多个开发框架

    只要是新 csproj 文件,指定多个开发框架真的是相当的简单。

    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
        <TargetFrameworks>net45;netstandard2.0</TargetFrameworks>
      </PropertyGroup>
      <!-- 这个文件里的其他内容 -->
    </Project>

    特别注意!!!TargetFramework 从单数形式变为了复数形式 TargetFrameworks!!!这个时候,TargetFramework 是编译时自动指定的。

    如果是对以上多框架的项目进行单元测试,考虑到编译的目标平台是多个的,单元测试项目也需要指定多个目标框架。

    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
        <TargetFrameworks>net471;netcoreapp2.0</TargetFrameworks>
        <IsPackable>false</IsPackable>
      </PropertyGroup>
      <!-- 这个文件里的其他内容 -->
    </Project>

    多框架项目的坑以及如何避坑

    微软的官方文档 How to: Configure Projects to Target Multiple Platforms - Microsoft Docs 中只说了如何指定多个目标框架,并没有提及设好了之后的坑。

    如果多开发框架中包含了低版本的 .NET Framework,例如 4.0/4.5 等,那么这些坑才比较容易凸显——因为这些版本的 .NET Framework 与 .NET Standard 的第三方库差异较大。所以,我们需要有方法来解决其第三方库引用的差异。这时需要在 csproj 文件中指定包含条件。例如:

    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
        <TargetFrameworks>net471;netcoreapp2.0</TargetFrameworks>
        <OutputType Condition="'$(TargetFramework)'!='netcoreapp2.0'">Exe</OutputType>
        <IsPackable>false</IsPackable>
      </PropertyGroup>
    
      <!-- 这里的引用是二者共有的 -->
      <ItemGroup>
        <PackageReference Include="MSTest.TestAdapter" Version="1.2.0" />
        <PackageReference Include="MSTest.TestFramework" Version="1.2.0" />
      </ItemGroup>
    
      <!-- 这里的引用用于非 .NET Core 框架 -->
      <ItemGroup Condition="'$(TargetFramework)'!='netcoreapp2.0'">
        <PackageReference Include="Xxx" Version="1.0.*" />
      </ItemGroup>
    
      <!-- 这里的引用用于 .NET Core 框架 -->
      <ItemGroup Condition="'$(TargetFramework)'=='netcoreapp2.0'">
        <PackageReference Include="Yyy" Version="1.0.*" />
      </ItemGroup>
    
    </Project>

    参考资料

  • 相关阅读:
    1041 考试座位号
    1040 有几个PAT
    1039 到底买不买
    1038 统计同成绩学生
    1037 在霍格沃茨找零钱
    1036 跟奥巴马一起编程
    1035 插入与归并
    vue-router--路由传参
    vue-router--路由原理
    vuex--在computed中使用
  • 原文地址:https://www.cnblogs.com/walterlv/p/10236498.html
Copyright © 2011-2022 走看看