如何在 Ubuntu 安裝 .NET Core

到網頁 https://dotnet.microsoft.com/download/dotnet-core/2.2 去下載安裝檔
把檔案上傳到 Ubuntu
在安裝檔目錄下
輸入安裝指令
mkdir -p $HOME/dotnet2.2.107 && tar zxf dotnet-sdk-2.2.107-linux-x64.tar.gz -C $HOME/dotnet2.2.107

要測試的話
可以輸入 $HOME/dotnet2.2.107/dotnet --version
就可以看到 dotnet 的版本號碼

Blazor for .Net core 3.0.100-preview6-012264 無法用 Visual Studio 2019 偵錯問題解決方法

在 Chrome 中收到 ERR_SPDY_INADEQUATE_TRANSPORT_SECURITY 錯誤
在 Firefox 中收到 NS_ERROR_NET_INADEQUATE_SECURITY 錯誤

請執行下列命令來更新開發憑證：

dotnet dev-certs https --clean
dotnet dev-certs https --trust

安裝 .NET Core 3.0 Preview 7 的 Blazor 專案 -

先安裝 .NET Core 3.0 Preview 7
https://dotnet.microsoft.com/download/dotnet-core/3.0

再安裝 Visual Studio 2019 Preview
https://visualstudio.microsoft.com/zh-hant/vs/preview/?rr=https%3A%2F%2Fwww.cnblogs.com%2F

最後安裝 Blazor 延伸模組
https://marketplace.visualstudio.com/items?itemName=aspnet.blazor

就可以在開新專案時選擇 Blazor 類型的專案了

ASP.NET Core （包含 .NET Core）如何超簡單讀取客制化 json 檔案

利用 ConfigurationBuilder 就可以讀取客制化的 Json 檔案

                // 讀取客制化 Json 檔案
                // Json 檔案格為 appsettings.[目前組態].json
                string appsettingJson_ = $"appsettings.{DebuggingProperties.Config}.json";

                // 讀取目錄內客制化的 Json 檔案
                _config = new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile(appsettingJson_, optional: true)
                .Build();

DebuggingProperties.Config 的原理可以參考這篇：怎樣判斷 .NET Core （包含 ASP.NET Core）是 Debug 或 Release ?

ASP.NET Core （包含 .NET Core）依據組態為 Release 或 Debug 取得各自的設定內容

首先取得目前的組態，如下列的程式碼：
原理可以參考這篇：怎樣判斷 .NET Core （包含 ASP.NET Core）是 Debug 或 Release ?

    public static class DebuggingProperties
    {
        /// 

        /// 檢查當前正在運行的程式組態。
        /// 
        public static string Config
        {
            get
            {
                if (_ConfigAttribute == null)
                {
                    var assembly = Assembly.GetEntryAssembly();
                    if (assembly == null)
                    {
                        // 由於調用 GetFrames 的 StackTrace 實例沒有跳過任何幀，所以 GetFrames() 一定不為 null。
                        assembly = new StackTrace().GetFrames().Last().GetMethod().Module.Assembly;
                    }

                    var assemblyConfigurationAttribute = assembly.GetCustomAttribute();
                    _ConfigAttribute = assemblyConfigurationAttribute.Configuration;
                }

                return _ConfigAttribute;
            }
        }

        private static string _ConfigAttribute;
    }

appsettings.json 檔案設定格式如下：

{
  "Release": {
    "DefaultConnection": " Release Server"
  },
  "Debug": {
    "DefaultConnection": "Debug Server"
  }
}

需要組態設定時，只要如下呼叫即可： 在 Startup.cs 新增下列程式碼：

            public IConfiguration _config { get; } 

// 取的 appsettings.json 的設定
public Startup(IConfiguration configuration)      
{                                               
    _config = configuration;                
}                                                 


// 執行中取得組態設定的方式
public void Run()
{
    // 取的 appsettings.json 的 Release 或 Debug 組態設定
    var cfg_ = _config.GetSection(DebuggingProperties.Config);
    // 取的 appsettings.json 指定組態設定內容
    string def_ = cfg_ .GetValue("DefaultConnection");
            }

怎樣判斷 .NET Core （包含 ASP.NET Core）是 Debug 或 Release ?

用 JustDecompile 可以看到 DLL 的資訊

下面是 Debug 版本的資訊 ：

下面是 Release 版本的資訊 ：

這樣我們可以用下面的程式碼，判斷 DLL 是否為 Debug 版本。

在多個 .NET Core 版本之間進行切換

建立一個 global.json
{
  "sdk": {
    "version": "2.1.503"
  }
}
只要指定版本號，就能執行 .NET Core 特定版本號

升級 dotnet core 3.0 造成 Blazor for dotnet core 2.1 無法執行的問題解決

編譯後在 ubuntu 上執行發生錯誤訊息：
It was not possible to find any compatible framework version
The specified framework 'Microsoft.AspNetCore.App', version '2.1.8' was not found.

原因是 AspNetCore 預設使用 2.1.8
而 Blazor 只能在 2.1.7 上正常執行
解決方法是修改 Visual Studio 的 *.csproj
指定 AspNetCore 的版本號為 2.1.7
PackageReference Include="Microsoft.AspNetCore.App"

修改設定指定版本為 2.1.7
(AWS EC2 預設 Image 為 2.1.2 改成 2.1.2 試過可以正常執行)
PackageReference Include="Microsoft.AspNetCore.App" Version="2.1.7"

重新編譯後的新版本就能正常的執行了

PS.如果在 Visual Studio 2017 出現錯誤訊息：
Unhandled Exception: System.IO.FileLoadException: Could not load file or assembly 'Microsoft.AspNetCore, Version=2.1.7.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)
只要把剛剛的修改還原就能 Debug 了。

NLog 的 NLog.config 的設定簡介

NLog 的 NLog.config 的設定內容主要有兩個 target 與 rules


target 內容如下：

target name="fatalFile" xsi:type="File"
        fileName="${basedir}/Logs/FatalFile.txt"
        layout="${longdate} | ${level:uppercase=true} | ${message} ${newline}"

target  的 fileName 為檔案名稱。
${basedir} 表示目前程式執行的目錄（暫訂為 c:\temp）
所以輸出的檔名會是 c:\temp\Logs\FatalFile.txt
target  的 layout 為 Log 輸出的格式，如下：

2019-01-10 14:25:03.0966 | TRACE | 程式結束執行！

${longdate} 代表寫 Log 當下的時間
${level:uppercase=true} 代表 log level 並轉大寫
${message} ${newline} 代表 寫下 Log 內容並換行。

rules 內容如下：

logger name="*" levels="Trace, Debug, Info, Warn" writeTo="fatalFile"

writeTo 也就是指剛剛 target name

levels 是要記錄的 log level

透過 supervisord 執行 .NET Core 程式

利用 WinSCP 將自己開發的 .NET Core 程式上傳到 Ubuntu 上，
再透過 PuTTY 執行 .NET Core 程式，當 PuTTY 關閉後，
.NET Core 程式也會關閉。

所以我需要利用 supervisord 來管理 .NET Core 程式，
在 PuTTY 關閉後，也能正常運行。

在 Ubuntu 安裝 supervisord

先執行 sudo su 換 root 權限
apt-get update
apt-get install -y supervisor



安裝完，輸入 service supervisor status 看看是否安裝成功。



編輯 supervisor 設定檔

先執行 sudo su 換 root 權限

vim /etc/supervisor/supervisord.conf

進入 vim 修改 supervisord.conf 檔案



按下 i （-- INSERT --）

新增 supervisor 設定

[program:你的程式]
command=/usr/bin/dotnet /home/使用者/你的程式目錄/你的程式.dll

directory=/home/使用者/你的程式目錄/

user =root

autostart=true

autorestart=true

startsecs=3

stderr_logfile=/tmp/你的程式_err.log

stdout_logfile=/tmp/你的程式.log

environment=ASPNETCORE__ENVIRONMENT=Production

或直接指定路徑
command=/usr/share/dotnet/dotnet /home/你的程式目錄/你的程式.dll

PS. dotnet 安裝路徑可以用 dotnet --info 查到


輸入 :wq 存檔後，用指令重新啟動 supervisord

supervisorctl reload

輸入 service supervisor status 看看是否設定成功

用 supervisor 啟動你的程式

supervisorctl start 你的程式

Blazor 在 Ubuntu 一執行就當機的解決方法

Blazor 官方有這個 Bug 回報

Update to SDK 2.2.100 throws "An item with the same key has already been added. Key: .wasm" #5666
https://github.com/aspnet/AspNetCore/issues/5666

看起來，官方 .NET Core 3.0 才有機會修正此問題，
只好另求他法，我自己測試過只要把 Ubuntu 的 .NET Core 版本降到 2.1
Microsoft.AspNetCore.App 2.1.7 或 2.1.2 (AWS EC2 預設版本)
就可以正常執行了。

在 Ubuntu 上 Blazor 為安裝 .NET Core 2.1.503 (ASP.NET Core 2.1.7)

因為 Blazor 只支援到 ASP.NET Core 2.1.7
(PS.試過 AWS EC2 預設 ASP.NET Core 2.1.2 也能正常執行 2.1.302 版)
所以不抓最新版 2.1.504
而是抓 2.1.503 版
先執行 sudo su 換 root 權限(輸入 cd $HOME 是否在要安裝的目錄上，不是才需要換 root)
並且 sudo apt-get install 的安裝方式，隨著版本推進，會有很多錯誤發生。
所以採用抓取 .NET Core Binaries 2.1.503 版的檔案，還進行更新，網址如下：
https://dotnet.microsoft.com/download/thank-you/dotnet-sdk-2.1.503-linux-x64-binaries

需要其他版本可以在這邊下載適合的 .NET Core Binaries 檔案，網址如下：
https://dotnet.microsoft.com/download/dotnet-core/2.1

在 dotnet-sdk-2.1.503-linux-x64.tar.gz 目錄下執行下面的指令：

先執行 sudo su 換 root 權限
mkdir -p $HOME/dotnet ＆＆ tar zxf dotnet-sdk-2.1.503-linux-x64.tar.gz -C $HOME/dotnet
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet

執行 dotnet  --info 驗證是否安裝成功

關閉 Session 後
下次登入如果因為 export 沒有 DOTNET_ROOT
（目前有遇到 WSL 關閉後前面的 export 會消失）
而無法執行 dotnet

可以用 vim /etc/profile（先執行 sudo su 換 root 權限）

修改系統檔案都要用 root 權限
先執行 sudo su 換 root 權限
然後
按下 i （-- INSERT --）
在 profile 檔案末端加上

export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet

如果一樣無法執行 dotnet
可以用指令測試一下是否能直接執行 dotnet
通常是 /usr/share/dotnet/dotnet
如果可執行
就可以改成絕對路徑
export DOTNET_ROOT=/usr/share/dotnet
export PATH=$PATH:/usr/share/dotnet
重新登入後，試試看是否能正常執行 dotnet

輸入 ：wq
離開 vim 編輯

輸入 . /etc/profile 重新載入  profile 檔案
就能在任何目錄上呼叫 dotnet 了