Introdução
Este guia mostra como criar um fluxo de trabalho que executa a CI (integração contínua) para seu projeto de Xamarin. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável.
Para obter uma lista completa das versões do SDK do Xamarin disponíveis nos executores de macOS hospedados por GitHub Actions, consulte o arquivo LEIAME para a versão do macOS que você deseja usar no repositório GitHub Actions Runner Images.
Pré-requisitos
Recomendamos que você tenha uma compreensão básica de Xamarin, .NET Core SDK, YAML, opções de configuração de fluxo de trabalho e como criar um arquivo de fluxo de trabalho. Para saber mais, veja:
-
[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions) -
[Introdução ao .NET](https://dotnet.microsoft.com/learn) -
[Saiba mais sobre o Xamarin](https://dotnet.microsoft.com/learn/xamarin)
Criando aplicativos Xamarin.iOS
O exemplo a seguir demonstra como alterar as versões padrão do SDK do Xamarin e construir um aplicativo Xamarin.iOS.
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
Desenvolvendo aplicativos Xamarin.Android
O exemplo a seguir demonstra como alterar as versões padrão do SDK Xamarin e criar um Xamarin. Aplicativo Android.
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
Especificando uma versão .NET
Para usar uma versão pré-instalada do SDK do .NET Core em um executor hospedado pelo GitHub, use a ação setup-dotnet. Essa ação localiza uma versão específica de .NET do cache de ferramentas em cada executor e adiciona os binários necessários a PATH. Estas alterações persistirão para o resto do trabalho.
A ação setup-dotnet é a maneira recomendada de usar .NET com GitHub Actions, pois garante um comportamento consistente entre diferentes versões de runners e do .NET. Se você estiver usando um executor auto-hospedado, deverá instalar .NET e adicioná-lo a PATH. Para obter mais informações, confira a ação setup-dotnet.