发布 Rafy .NET Standard 版本 Nuget 包

img

去年年中,Rafy 框架的源码就已经支持了 Net Standard 2.0 版本。其开源代码也已经上传到 Github 中:https://github.com/zgynhqf/rafy/tree/NetStandard2.0 。但是这都只是在源码层面支持 NS2.0,并没有发布其正式的 Nuget 包。要使用这个版本的开发者,不得不自己下载源码进行编译。

最近,使用 Net Core 的开发者越来越多。所以我们决定发布一个正式的 Nuget 包,以方便 Net Core 的开发都可以方便地下载、更新 Rafy 框架进行使用。

发布后,开发者在 Nuget 中再搜索 Rafy 的最新版本时,就已经支持 Net Standard 2.0 了:

发布 Rafy .NET Standard 版本 Nuget 包_第1张图片

项目支持多版本的改造步骤

过程中其实没有想到,要发布一个同时支持 Net Standard 2.0 和 Net Framework 4.5 版本的 Nuget 包,还是比较繁琐的。需要将原来的两个分支的代码合并到一起,并通过预处理命令来分别编译为不同版本。

下面,简单记录一下一些重要的步骤:

  • 创建并使用新的 Net Standard 项目文件格式来创建。

    发布 Rafy .NET Standard 版本 Nuget 包_第2张图片

  • 修改 Rafy.csproj 文件,使其支持多个 .NET 版本:


   
     
     net45;netstandard2.0
  • Rafy.csproj 文件中,为不同的版本添加不同的引用:

     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     

     
       
       
       
       
       
       
       
       
       
       
       
       
     
  • 还可以自定义一些缩写的常量:

     
       NS2
     

  • 修改合并后的项目中的所有相关代码,都使用预处理命令来区别不同的版本,如:
           private void EnsureLoaded()
           {
               if (_section == null)
               {
   #if NET45
                   _section = ConfigurationManager.GetSection("rafy") as RafyConfigurationSection;
                   if (_section == null) _section = new RafyConfigurationSection();
   #endif
       
   #if NS2
                   var rafyRawSection = ConfigurationHelper.Configuration.GetSection("rafy");
                   if (rafyRawSection == null)
                   {
                       throw new InvalidProgramException("配置文件中没有 rafy 配置节,请检查配置文件。");
                   }
                   _section = new RafyConfigurationSection();
                   rafyRawSection.Bind(_section);
   #endif
               }
           }
  • 配置项目为编译时生成对应的 Nuget 包。

    发布 Rafy .NET Standard 版本 Nuget 包_第3张图片

  • 生成,并发布。最终生成的 Nuget 包格式是这样的:

    发布 Rafy .NET Standard 版本 Nuget 包_第4张图片

通过上述几步,就使得 Rafy 框架支持了 Net Standard 版本了。同时,我们还把 Rafy 中的一些其它公共插件也都支持了多版本。以后会不定期升级每一个插件。

你可能感兴趣的:(发布 Rafy .NET Standard 版本 Nuget 包)