Github-gehostete Runner für Unternehmen
Einführung
In diesem Leitfaden erfahren Sie, wie Sie einen Workflow erstellen, der eine kontinuierliche Integration (CI) für Ihr Xamarin Projekt durchführt. Der Workflow, den Du erstellst, zeigt Dir, wenn Commits zu einem Pull-Request zu Build- oder Testfehlern für deinen Standard-Zweig führen. Dieser Ansatz kann dazu beitragen, dass Dein Code immer brauchbar ist.
Eine vollständige Liste der verfügbaren Xamarin SDK-Versionen in den GitHub Actions-gehosteten macOS-Läufern finden Sie in der README-Datei für die Version von macOS, die Sie in der GitHub Actions Runner Images Repository verwenden möchten.
Voraussetzungen
Es wird empfohlen, ein grundlegendes Verständnis für Xamarin, .NET Core SDK, YAML, Workflowkonfigurationsoptionen und das Erstellen einer Workflowdatei zu haben. Weitere Informationen finden Sie unter:
-
[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions) -
[Erste Schritte mit .NET](https://dotnet.microsoft.com/learn) -
[Lernen Sie Xamarin kennen](https://dotnet.microsoft.com/learn/xamarin)
Erstellen von Xamarin.iOS-Apps
Im folgenden Beispiel wird veranschaulicht, wie Sie die Standardversionen Xamarin SDK ändern und eine Xamarin.iOS-Anwendung erstellen.
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
Erstellen von Xamarin.Android-Apps
Im folgenden Beispiel wird veranschaulicht, wie Sie die Standardversionen des Xamarin SDKs ändern und eine Xamarin.Android-Anwendung erstellen.
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
Angeben einer .NET Version
Um eine vorinstallierte Version des .NET Core SDK auf einem GitHub-gehosteten Runner zu verwenden, verwenden Sie die Aktion setup-dotnet. Diese Aktion findet eine bestimmte Version von .NET aus dem Toolscache für jeden Läufer und fügt die erforderlichen Binärdateien zu PATH hinzu. Diese Änderungen bleiben für den Rest des Auftrags beibehalten.
Die setup-dotnet-Aktion ist die empfohlene Vorgehensweise zur Verwendung von .NET mit GitHub Actions, da sie ein konsistentes Verhalten über verschiedene Runner und unterschiedliche Versionen von .NET gewährleistet. Wenn Sie einen selbst gehosteten Runner verwenden, müssen Sie .NET installieren und zu PATH hinzufügen. Weitere Informationen findest du unter der Aktion setup-dotnet.