适合 .NET 开发者用的 GitHub Actions（时不时更新）
适合 .NET 开发者用的 GitHub Actions（时不时更新）
本文制作并长期更新适合 .NET 开发者用的 GitHub Actions。整理方式为整个文件而不是单个可用的模块，这样可以方便大家以最快的速度为自己的项目添加 GitHub Actions。当然自己改改也可。
.NET 编译与单元测试（全平台）
功能：编译你的 .NET 项目，并进行单元测试。
适用：如果你的项目是纯 .NET 项目，无论项目是 .NET Core 还是 .NET Framework，无论是 Asp.NET Core 还是 WPF / Windows Forms，都可以用这个文件来编译和单元测试。
要求：仓库的根目录有且仅有一个 sln 文件，且这个文件包含了所有重要的项目和单元测试。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 | name: .NET Build & Test on: push: branches: [ master ] pull_request: branches: [ master ] jobs: build: strategy: matrix: configuration: [Debug, Release] runs-on: windows-latest steps: - name: Checkout uses: actions/checkout@v2 - name: Setup uses: actions/setup-dotnet@v1 - name: Build run: dotnet build --configuration $env:Configuration env: Configuration: ${{ matrix.configuration }} - name: Test run: dotnet test --configuration $env:Configuration env: Configuration: ${{ matrix.configuration }} |
|---|
.NET 编译与单元测试（仅限 Windows 系统下的编译）
功能：编译你的 .NET 项目，并进行单元测试。
适用：如果你的项目是纯 .NET 项目，无论项目是 .NET Core 还是 .NET Framework，无论是 Asp.NET Core 还是 WPF / Windows Forms，都可以用这个文件来编译和单元测试。
要求：仓库的根目录有且仅有一个 sln 文件，且这个文件包含了所有重要的项目和单元测试。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 | name: .NET Build & Test on: push: branches: [ master ] pull_request: branches: [ master ] jobs: build: strategy: matrix: configuration: [Debug, Release] runs-on: windows-latest steps: - name: Checkout uses: actions/checkout@v2 with: fetch-depth: 0 # 安装 .NET Core - name: Install .NET Core uses: actions/setup-dotnet@v1 with: dotnet-version: 3.1.202 # 添加 MSBuild.exe 到环境变量: https://github.com/microsoft/setup-msbuild - name: Add msbuild to PATH uses: microsoft/[email protected] # 安装 NuGet（如果后面需要，可以使用它） - name: Setup NuGet uses: nuget/setup-nuget@v1 with: nuget-api-key: ${{ secrets.NuGetAPIKey }} nuget-version: '5.x' # 编译整个项目 - name: Build the solution run: msbuild /p:Configuration=$env:Configuration -restore env: Configuration: ${{ matrix.configuration }} # 执行单元测试 - name: Execute unit tests run: dotnet test -c $env:Configuration env: Configuration: ${{ matrix.configuration }} |
|---|
在这个文件中：
- 我们测试编译了 DEBUG 和 Release 两个不同的环境
- 我们使用的是 msbuild 来编译，因为这样对旧项目的兼容性最好，当然也就失去了跨平台的能力
NuGet Push
功能：如果你的项目是要推送 NuGet 包的，那么可以使用此工作流推送 NuGet 包。
适用：任何 .NET 项目。
要求：仓库的根目录有且仅有一个 sln 文件。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | name: NuGet Push on: push: branches: - master jobs: build: runs-on: windows-latest steps: - name: Checkout uses: actions/checkout@v2 - name: Setup uses: actions/setup-dotnet@v1 - name: Pack run: dotnet build --configuration Release - name: Push run: dotnet nuget push .\bin\Release\*.nupkg --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.NuGetAPIKey }} --skip-duplicate --no-symbols 1 |
|---|
关于最后的那个参数 1，很魔性，只要有任何一个值都行。参见：dotnet nuget push - Missing value for option · Issue #4864 · NuGet/Home。
自带环境
GitHub Actions 自带了很多环境可以用，这些自带的环境不需要再去配了：
本文会经常更新，请阅读原文： https://blog.walterlv.com/post/github-actions-for-dotnet-developers.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布，但务必保留文章署名 吕毅 （包含链接： https://blog.walterlv.com ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请 与我联系 ([email protected]) 。