使用setup-msbuild GitHub Action配置MSBuild

最新推荐文章于 2024-12-28 11:41:26 发布

蔡鸿烈Hope

最新推荐文章于 2024-12-28 11:41:26 发布

阅读量449

点赞数 5

本文链接：https://blog.youkuaiyun.com/gitblog_00523/article/details/142246275

版权

使用setup-msbuild GitHub Action配置MSBuild

setup-msbuild A GitHub Action to facilitate configuring MSBuild in the workflow PATH for building .NET Framework applications. 项目地址: https://gitcode.com/gh_mirrors/se/setup-msbuild

1. 项目介绍

setup-msbuild 是一个由微软提供的 GitHub Action，旨在帮助用户在 GitHub Actions 工作流中配置 MSBuild。MSBuild 是微软的构建平台，广泛用于构建 .NET Framework 应用程序。通过使用 setup-msbuild，用户可以轻松地将 MSBuild 工具添加到工作流的 PATH 环境变量中，从而在后续步骤中直接使用 msbuild 命令，而无需知道 MSBuild 的完整路径。

2. 项目快速启动

2.1 安装与配置

首先，确保你已经在 GitHub 仓库中启用了 GitHub Actions。然后，在你的工作流文件（通常是 .github/workflows/workflow.yml）中添加以下代码：

name: Build .NET Framework Application

on: [push]

jobs:
  build:
    runs-on: windows-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v2

    - name: Add msbuild to PATH
      uses: microsoft/setup-msbuild@v2

    - name: Build app for release
      run: msbuild src\YourProjectFile.csproj -t:rebuild -verbosity:diag -property:Configuration=Release

2.2 运行工作流

提交并推送你的更改到 GitHub 仓库。GitHub Actions 将自动触发并运行你定义的工作流。你可以在 GitHub 仓库的 "Actions" 选项卡中查看工作流的运行状态和日志。

3. 应用案例和最佳实践

3.1 应用案例

setup-msbuild 适用于需要构建 .NET Framework 应用程序的场景。例如，你可以在 CI/CD 管道中使用它来自动化构建和部署过程。

3.2 最佳实践

指定 Visual Studio 版本：如果你的 GitHub Actions 运行器安装了多个版本的 Visual Studio，你可以通过 vs-version 参数指定要使用的 MSBuild 版本。
```
- name: Add msbuild to PATH
  uses: microsoft/setup-msbuild@v2
  with:
    vs-version: '[16.4,16.5)'
```
使用预发布版本：如果你需要使用预发布的 Visual Studio 版本，可以通过 vs-prerelease 参数启用预发布版本。
```
- name: Add msbuild to PATH
  uses: microsoft/setup-msbuild@v2
  with:
    vs-prerelease: true
```