Introduction
Ce guide vous montre comment créer un flux de travail qui effectue une intégration continue (CI) pour votre projet de Xamarin. Le workflow que vous créez vous permet de voir quand les commits de pull request entraînent des échecs de build ou de test dans votre branche par défaut. Cette approche peut vous aider à garantir l’intégrité de votre code.
Pour obtenir la liste complète des versions Xamarin sdk disponibles sur les exécuteurs GitHub Actionshébergés sur macOS, consultez le fichier README pour la version de macOS que vous souhaitez utiliser dans le référentiel GitHub Actions Référentiel Images Runner.
Prérequis
Nous vous recommandons d’avoir une compréhension de base des Xamarin, .NET Kit de développement logiciel (SDK) Core, YAML, options de configuration de flux de travail et comment créer un fichier de flux de travail. Pour plus d’informations, consultez l’article suivant :
- AUTOTITRE
-
[Getting started with .NET](https://dotnet.microsoft.com/learn) -
[Learn Xamarin](https://dotnet.microsoft.com/learn/xamarin)
Création d’applications Xamarin.iOS
L’exemple ci-dessous montre comment modifier les versions Xamarin SDK par défaut et générer une application 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
Création d'applications Xamarin.Android
L’exemple ci-dessous montre comment modifier les versions Xamarin SDK par défaut et générer un Xamarin. Application 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
Spécification d’une version .NET
Pour utiliser une version préinstallée du SDK .NET Core sur un runner hébergé dans GitHub, utilisez l’action setup-dotnet. Cette action recherche une version spécifique de .NET à partir du cache des outils sur chaque exécuteur et ajoute les fichiers binaires nécessaires à PATH. Ces modifications seront conservées pendant toute la durée du travail.
L’action setup-dotnet est la méthode recommandée d’utilisation de .NET avec GitHub Actions, car elle garantit un comportement cohérent entre différents exécuteurs et différentes versions de .NET. Si vous utilisez un exécuteur auto-hébergé, vous devez installer .NET et l’ajouter à PATH. Pour plus d’informations, consultez l’action .