共用方式為


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

在本快速入門中,您將了解如何建立 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 分支上發生 pushpull_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 的作業系統名稱。 nameruns-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 檔案內視覺上具有吸引力。 若要新增工作流程狀態徽章:

  1. 從 GitHub 存放庫,選取 [動作] 瀏覽選項。

  2. 所有存放庫工作流程都會顯示在左側,選取所需的工作流程和省略符號 (...) 按鈕。

    • 省略符號 (...) 按鈕會展開所選工作流程的功能表選項。
  3. 選取 [建立狀態徽章] 功能表選項。

    GitHub: Create status badge

  4. 選取 [複製狀態徽章 Markdown] 按鈕。

    GitHub: Copy status badge Markdown

  5. 將 Markdown 貼上到 README.md 檔案,儲存檔案、認可並推送變更。

如需詳細資訊,請參閱新增工作流程狀態徽章

範例測試工作流程狀態徽章

通過 失敗 無狀態
GitHub: test passing badge GitHub: test failing badge GitHub: test no-status badge

另請參閱

下一步