XamariniOS@2 : Xamarin.iOS v2-Aufgabe

Artikel
07/02/2024

Verwenden Sie diese Aufgabe in einer Pipeline, um eine iOS-App mit Xamarin unter macOS zu erstellen. Weitere Informationen finden Sie unter Xamarin-Anleitung und Signieren Ihrer App während der CI.

Syntax

# Xamarin.iOS v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

Eingaben

solutionFile - Lösung
Eingabealias: solution. string. Erforderlich. Standardwert. **/*.sln.

Gibt den relativen Pfad vom Repositorystamm der Projektmappe oder des Xamarin.iOS Csproj-Projekts zum Build an. Kann Wildcards enthalten.

configuration - Konfiguration
string. Erforderlich. Standardwert. Release.

Gibt die Konfiguration an. Standardkonfigurationen sind Ad-hoc, AppStore, Debug und Release.

clean - Sauber
boolean. Standardwert. false.

Optional. Führt einen sauberen Build (/t:clean) vor dem Build aus.

packageApp - Erstellen eines App-Pakets
boolean. Standardwert. true.

Wenn diese Einstellung auf truefestgelegt ist, wird ein IPA als Teil des Builds generiert.

buildForSimulator - Build für iOS-Simulator
Eingabealias: forSimulator. boolean. Standardwert. false.

Optional. Builds für den iOS-Simulator anstelle von physischen iOS-Geräten.

runNugetRestore - Ausführen der NuGet-Wiederherstellung
boolean. Standardwert. false.

Wird auf der Xamarin iOS-Lösung ausgeführt nuget restore , um alle Pakete zu installieren, auf die verwiesen wird, bevor der Build ausgeführt wird. Das nuget Tool im PFAD des Build-Agent-Computers wird verwendet. Verwenden Sie den NuGet-Installer-Task, um eine andere Version von NuGet zu verwenden oder zusätzliche Argumente festzulegen.

args - Argumente
string.

Optional. Gibt zusätzliche Befehlszeilenargumente an, die zum Erstellen verwendet werden.

workingDirectory - Arbeitsverzeichnis
Eingabealias: cwd. string.

Optional. Gibt das Arbeitsverzeichnis an, in dem Builds ausgeführt werden. Wenn der Wert leer ist, wird der Stamm des Repositorys verwendet.

mdtoolFile - Buildtoolpfad
Eingabealias: buildToolLocation | mdtoolLocation. string.

Optional. Gibt den Pfad zu xbuild (dem Xamarin Studio-Monobuildtool) oder MSBuild (dem Visual Studio für Mac Buildtool) an. Wenn der Wert leer ist, wird der Standardmäßige xbuild- oder MSBuild-Pfad verwendet.

signingIdentity - Signaturidentität
Eingabealias: iosSigningIdentity. string.

Optional. Überschreibt die Signaturidentität, die zum Signieren des Builds verwendet wird. Wenn der Wert leer ist, wird die Einstellung im Xcode-Projekt verwendet. Möglicherweise müssen Sie auswählen signingUnlockDefaultKeychain , wenn Sie diese Option verwenden.

signingProvisioningProfileID - UUID des Bereitstellungsprofils
Eingabealias: provProfileUuid. string.

Optional. Gibt die UUID einer installierten Bereitstellungsprofilüberschreibung an, die für diesen Build verwendet werden soll.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe in einer Pipeline, um eine iOS-App mit Xamarin unter macOS zu erstellen. Weitere Informationen finden Sie unter Xamarin-Anleitung und Signieren Ihrer App während der CI.

Neuerungen in dieser Aufgabenversion

Die Einrichtung der iOS-Registrierung wurde aus der Aufgabe entfernt. Verwenden Sie Secure Files mit unterstützenden Aufgaben Install Apple Certificate und Install Apple Provisioning Profile zum Einrichten der Signatur. Die Optionen wurden aktualisiert, um besser mit Visual Studio for Maczu arbeiten.

Beispiele

Erstellen Ihrer Xamarin-App

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, um Aufträge auszuführen, die diese Aufgabe verwenden: Xamarin.iOS
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Entwickeln

Freigeben über