快速入門：建立測試驗證 GitHub 工作流程

發行項
03/12/2024

在本快速入門中，您將了解如何建立 GitHub 工作流程來測試您的 .NET 原始程式碼。在 GitHub 內自動測試您的 .NET 程式碼稱為持續整合 (CI)，其中的提取要求或對來源的變更都會觸發程式工作流程執行。除了建置原始程式碼之外，測試可確保已編譯的原始程式碼可如作者預期運作。單元測試往往可作為立即的意見反應迴圈，以協助確保原始程式碼變更的有效性。

必要條件

GitHub 帳戶。
.NET 原始程式碼存放庫。

建立工作流程檔案

在 GitHub 存放庫中，將新的 YAML 檔案新增至 .github/workflows 目錄。選擇有意義的檔案名稱，可清楚指出工作流程要執行的動作的名稱。如需詳細資訊，請參閱工作流程檔案。

重要

GitHub 要求將工作流程組合檔案放在 .github/workflow 目錄內。

工作流程檔案通常會透過 jobs.<job_id>/steps[*] 定義一個或多個 GitHub Actions 的組合。如需詳細資訊，請參閱 GitHub Actions 的工作流程語法。

建立名為 build-and-test.yml 的新檔案，將下列 YML 內容複寫並貼上到其中：

name: build and test

on:
  push:
  pull_request:
    branches: [ main ]
    paths:
    - '**.cs'
    - '**.csproj'

env:
  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use

jobs:
  build-and-test:

    name: build-and-test-${{matrix.os}}
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest, macOS-latest]

    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies
      run: dotnet restore
      
    - name: Build
      run: dotnet build --configuration Release --no-restore
    
    - name: Test
      run: dotnet test --no-restore --verbosity normal

在上述工作流程組合中：

name: build and test 會定義名稱，「建置和測試」會出現在工作流程狀態徽章中。
```
name: build and test
```
on 節點表示觸發工作流程的事件：
```
on:
  push:
  pull_request:
    branches: [ main ]
    paths:
    - '**.cs'
    - '**.csproj'
```
- 在 main 分支上發生 push 或 pull_request 時觸發，其中任何檔案變更結尾都會是 .cs 或 .csproj 副檔名。
env 節點會定義具名環境變數 (env var)。
```
env:
  DOTNET_VERSION: '6.0.401' # The .NET SDK version to use
```
- 環境變數 DOTNET_VERSION 會高指派值 '6.0.401'。稍後會參考環境變數，以指定 actions/setup-dotnet@v3 GitHub Actions 的 dotnet-version。

jobs 節點會建置工作流程進行所需的步驟。

jobs:
  build-and-test:

    name: build-and-test-${{matrix.os}}
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest, macOS-latest]

    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Install dependencies
      run: dotnet restore
      
    - name: Build
      run: dotnet build --configuration Release --no-restore
    
    - name: Test
      run: dotnet test --no-restore --verbosity normal

有一個名為 build-<os> 的單一作業，其中的 <os> 是來自 strategy/matrix 的作業系統名稱。 name 和 runs-on 元素對 matrix/os 中的每個值為動態。這會在最新版本的 Ubuntu、Windows 和 macOS 上執行。
actions/setup-dotnet@v3 GitHub Actions 可用來使用來自 DOTNET_VERSION 環境變數指定的版本設定 .NET SDK。
呼叫 dotnet restore 命令。
呼叫 dotnet build 命令。
呼叫 dotnet test 命令。

建立工作流程狀態徽章

GitHub 存放庫的常見命名法是讓存放庫目錄根目錄有一個 README.md 檔案。同樣地，最好報告各種工作流程的最新狀態。所有工作流程都可以產生狀態徽章，其在 README.md 檔案內視覺上具有吸引力。若要新增工作流程狀態徽章：

從 GitHub 存放庫，選取 [動作] 瀏覽選項。
所有存放庫工作流程都會顯示在左側，選取所需的工作流程和省略符號 (...) 按鈕。
- 省略符號 (...) 按鈕會展開所選工作流程的功能表選項。
選取 [建立狀態徽章] 功能表選項。
選取 [複製狀態徽章 Markdown] 按鈕。
將 Markdown 貼上到 README.md 檔案，儲存檔案、認可並推送變更。