# 生成和测试Xamarin应用程序

了解如何在GitHub Actions中创建持续集成（CI）工作流，以生成和测试Xamarin应用程序。

## 简介

本指南介绍如何创建为Xamarin项目执行持续集成（CI）的工作流。 您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败； 这个方法可帮助确保您的代码始终是健康的。

有关 GitHub Actions 托管 macOS 运行器上可用的 Xamarin SDK 版本的完整列表，请参阅 README 文件，了解要在 [GitHub Actions 运行器映像存储库](https://github.com/actions/runner-images/tree/main/images/macos)中使用的 macOS 版本。

## 先决条件

建议你基本了解 Xamarin、.NET Core SDK、YAML、工作流配置选项以及如何创建工作流文件。 有关详细信息，请参阅：

* ```
          [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions)
  ```
* ```
          [.NET 入门](https://dotnet.microsoft.com/learn)
  ```
* ```
          [了解 Xamarin](https://dotnet.microsoft.com/learn/xamarin)
  ```

若要使用本指南中的示例，需要 GitHub.com 上的存储库。 macOS 运行程序在 GHE.com 的子域（例如 `octocorp.ghe.com`）上不可用。

## 生成 Xamarin.iOS 应用

下面的示例演示如何更改默认Xamarin SDK 版本并生成 Xamarin.iOS 应用程序。

```yaml
name: Build Xamarin.iOS app

on: [push]

jobs:
  build:

    runs-on: macos-latest

    steps:
    - uses: actions/checkout@v5
    - name: Set default Xamarin SDK versions
      run: |
        $VM_ASSETS/select-xamarin-sdk-v2.sh --mono=6.12 --ios=14.10

    - name: Set default Xcode 12.3
      run: |
        XCODE_ROOT=/Applications/Xcode_12.3.0.app
        echo "MD_APPLE_SDK_ROOT=$XCODE_ROOT" >> $GITHUB_ENV
        sudo xcode-select -s $XCODE_ROOT

    - name: Setup .NET Core SDK 5.0.x
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: '5.0.x'

    - name: Install dependencies
      run: nuget restore <sln_file_path>

    - name: Build
      run: msbuild <csproj_file_path> /p:Configuration=Debug /p:Platform=iPhoneSimulator /t:Rebuild
```

## 构建 Xamarin.Android 应用

下面的示例演示如何更改默认Xamarin SDK 版本并生成Xamarin。Android 应用程序。

```yaml
name: Build Xamarin.Android app

on: [push]

jobs:
  build:

    runs-on: macos-latest

    steps:
    - uses: actions/checkout@v5
    - name: Set default Xamarin SDK versions
      run: |
        $VM_ASSETS/select-xamarin-sdk-v2.sh --mono=6.10 --android=10.2

    - name: Setup .NET Core SDK 5.0.x
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: '5.0.x'

    - name: Install dependencies
      run: nuget restore <sln_file_path>

    - name: Build
      run: msbuild <csproj_file_path> /t:PackageForAndroid /p:Configuration=Debug
```

## 指定.NET版本

若要在 GitHub 托管的运行器上使用预安装的 .NET Core SDK 版本，请使用 `setup-dotnet` 操作。 此作从每个运行程序上的工具缓存中找到特定版本的.NET，并将必要的二进制文件添加到 `PATH`。 这些更改将在任务的剩余时间内持续有效。

```
          `setup-dotnet` 操作是 .NET 与 GitHub Actions 结合使用时的推荐方式，因为它能确保不同运行器和不同版本的 .NET 行为一致。 如果您使用自托管运行程序，则必须安装 .NET 并将其添加到 `PATH`。 有关详细信息，请参阅 [`setup-dotnet`](https://github.com/marketplace/actions/setup-net-core-sdk) 操作。
```