.NET Core 多框架支援(net45+netstandard20)實踐中遇到的一些問題總結
.NET Core 多框架支援(net45+netstandard20)實踐中遇到的一些問題總結
前言
本文主要是關於.NET Standard 程式碼 在多框架 和 多平臺 支援自己實踐過程中遇到的一些問題和解決辦法，希望給遇到這些問題的同學一點參考和思路。問題基本上都是提在 博問 和 Stackoverflow 中，不乏很多大佬都提供瞭解決問題的思路。接下來則是正文。
問題1：如何釋出多個 TargetFramework 的nuget 包
問題來源 ：主要是因為之前的類庫只提供了 .NET Standard2.0的版本。很多使用者反饋在 .NET Framework 下面不可用，於是有了這個問題。
1.2 問題描述：
在.csproj 檔案中聲明瞭
<TargetFrameworks>netstandard2.0;net471</TargetFrameworks>但是用dotnet pack 命令釋出時一直報以下的錯：
error MSB3644: 未找到框架“.NETFramework,Version=v4.7.1”的引用程式集。若要解決此問題，請安裝此框架版本的 SDK 或 Tar geting Pack，或將應用程式的目標重新指向已裝有 SDK 或 Targeting Pack 的框架版本。請注意，將從全域性程式集快取(GAC)解析程式集，並將使用這些程式集替換引用程式集。因此，程式集的目標可能未正確指向您所預期的框 架
然後安裝 net471的框架也安裝不了，請問如何解決？
遇到的問題是：專案依賴的是.net standard 2.0 ，但是使用者用的是 net461， netstand 的方法net461沒有，導致程式報錯！
1.3 解決辦法:
在.csproj 檔案中編寫如下
<TargetFrameworks>netstandard2.0;net471</TargetFrameworks>這時如果你編譯，或許會遇到System.Web 衝突的問題,或者是System.Web.HttpUlitity 在上下文中不存在。然後加入下面這句
<ItemGroup Condition=" '$(TargetFramework)' == 'net471' "> <Reference Include="System.Web" /> </ItemGroup>
就可以完美build 了，就解決了該問題了。
還有.net framework 4.7.1 框架裝不了的原因也找到了，是因為我用錯安裝包了，沒有下載 developer 的版本，正確的地址是
https://www.microsoft.com/en-us/download/details.aspx?id=56119 然而我用了這個 https://www.microsoft.com/en-us/download/details.aspx?id=56116
問題2：多個TargeFramework 導致關於Nuget包引用的問題
問題來源：這個問題是因為自己打包生成時的一個坑，忘記新增 Assembly Version了，導致釋出出去的包找不到引用的程式集。
2.1 問題描述：
關於 Nuget 包解析的，有個最近項原則， 詳情可參考NuGet 如何解析包依賴項 用一張微軟的圖來解釋就是：
這個時候會選擇最近的那個包，也就是 2.0 版本的。這沒問題。
今天遇到的一個問題是，我的一個Nuget包（稱之為 Package A 當前版本為 1.2.3 ）本來只支援 netstandard 2.0 的版本，csproj 檔案中的定義為
<TargetFramework>netstandard2.0</TargetFramework>我有另外一個產品ECS Nuget 包（稱之為 Package B 版本為 1.0.0），Package B 需要引用 Package A，
關係路線為 【Package B 1.0.0】 -> 【Package A 1.2.3】
這時，程式中呼叫這兩個包可以正常使用的。
後來，由於對 .net framework 的支援，我把原本 Package A 的nuget 包修改了，改成了如下
<TargetFrameworks>netstandard2.0;net45</TargetFrameworks>Package A 包生成版本為 1.3.2，這個時候，我再引用上述兩個包，發現編譯沒問題，但是在執行時報錯了。
我通過升級 Package B 可以解決上面問題，但是為什麼會出現這個錯誤呢？是因為使用了 TargetFrameworks ？還望大佬們指點指點
2.2 解決辦法
對比一下 publish 資料夾中的 .deps.json 檔案
按照這個思路，有了點眉目，也發現了一個程式中的Bug
第一張圖使用老版本的Core，生成出來的deps.json
可以看出 AssemblyVersion 和 FileVersion 都為空，但是通過 runtimeconfig.json 檔案可以找到 AssemblyVersion 和 FileVersion 為空的 dll。難道是因為 AssemblyVersion 和最開始的 1.3.2 檔案不匹配導致的嗎？
"aliyun-net-sdk-core/1.3.2": {
"dependencies": {
"Serilog": "2.5.0",
"Serilog.Exceptions": "4.0.0",
"Serilog.Sinks.File": "4.0.0"
},
"runtime": {
"lib/netstandard2.0/aliyun-net-sdk-core.dll": {
"assemblyVersion": "0.0.0.0",
"fileVersion": "0.0.0.0"
}
}
}下面是重新生成後的 deps.json 檔案，可以正常執行之前低版本的專案包。
結論： 由於 引用的 1.3.2 版本， 然而 CLR 在載入程式集時，找不到 Version 為 1.3.2 的DLL，於是就找原本專案引用的 1.2.3 版本，沒有找到，於是報錯。理清楚了。
問題3：target framework 為 .net 45 的專案，可以在 Linux 系統下編譯嗎？
問題來源：Linux上無法打包net45似乎是很正常的事，之前都是通過 windows docker 映象打包好，然後推送到 nuget，但是由於公司網路的限制以及互通性上會有點問題，關於 .NET SDK 程式集的打包就遇到了無法在 Linux上打包 net45 程式集的問題，通過在 Github上跟蹤 Issue，終於發現瞭解決辦法。具體如下：
3.1 問題描述
Target Framework 為 .net framework 4.5 的專案，可以不可以在 Linux 下 dotnet build 生成 net45 的dll 和 執行 dotnet pack 打包生成 net45 和 netstandard2.0 的包?
3.2 解決方案
答案是可以的，哈哈。微軟在Nuget針對這個專門釋出了一個Nuget包，想要檢視詳細 Issue 的可以在這裡檢視 https://github.com/dotnet/designs/pull/33
Nuget上面包的地址為: https://www.nuget.org/packages/Microsoft.NETFramework.ReferenceAssemblies/1.0.0-preview.2
只需要在你的csproj 檔案中修改新增如下即可：
<PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies"
Version="1.0.0-preview.1"
PrivateAssets="All" />
已在伺服器上測試過：具體csporj 配置可以參考 https://github.com/aliyun/aliyun-openapi-net-sdk/blob/master/aliyun-net-sdk-core/aliyun-net-sdk-core.vs2017.csproj
如果有表述或者難以理解 以及 可以改進的地方，麻煩大家提出來。進行交流和討論。
PS：還有一個就是中文Windows 作業系統中，想要在終端上讓異常資訊已英文的形式顯示，需要更改系統的語言，使用
Thread.CurrentThread.CurrentCulture = CultureInfo.InvariantCulture;
Thread.CurrentThread.CurrentUICulture = CultureInfo.InvariantCulture;
在有些情況下以英文顯示，有些還是以中文顯示。比如 WebRequest 返回的 WebException 就會以中文顯示，改一下作業系統語言則正常。