XamariniOS@1 – Xamarin.iOS v1-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 v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  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: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

Eingaben

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

Gibt den relativen Pfad vom Repositorystamm der Xamarin.iOS Projektmappe 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 auf truefestgelegt ist, wird ein IPA als Teil des Builds generiert.

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

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

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

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 für den Build 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.

buildToolOption - Buildtool
Eingabealias: buildTool. string. Zulässige Werte: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio für Mac)). Standardwert. xbuild.

Gibt die Buildtools an, die vom Task verwendet werden.

mdtoolFile - Buildtoolpfad
Eingabealias: 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.

signingOption - Überschreiben mit
Eingabealias: signMethod. string. Zulässige Werte: file (Dateiinhalt), id (Bezeichner). Standardwert. file.

Verwenden Sie diese Eingabe, wenn der Build eine Signatur- oder Bereitstellungsmethode verwendet, die sich von der Standardeinstellung unterscheidet. Wählen Sie file aus, ob Sie ein P12-Zertifikat und ein Bereitstellungsprofil verwenden möchten. Wählen Sie aus id , um Signatureinstellungen aus dem Standardschlüsselbund und vorinstallierten Profilen abzurufen. Lassen Sie die entsprechenden Felder leer, wenn Sie die Standardbuildeinstellungen nicht außer Kraft setzen möchten.

signingIdentity - Signaturidentität
Eingabealias: iosSigningIdentity. string. Optional. Verwenden Sie , wenn signMethod = id.

Ü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 , ob Sie diese Option verwenden.

signingUnlockDefaultKeychain - Entsperren des Standardschlüsselbunds
Eingabealias: unlockDefaultKeychain. boolean. Optional. Verwenden Sie , wenn signMethod = id. Standardwert. false.

Behebt Fehler "Benutzerinteraktion ist nicht zulässig", indem der Standardschlüsselbund entsperrt wird.

signingDefaultKeychainPassword - Standardschlüsselbundkennwort
Eingabealias: defaultKeychainPassword. string. Optional. Verwenden Sie , wenn signMethod = id.

Gibt das Kennwort zum Entsperren des Standardschlüsselbunds an, wenn signingUnlockDefaultKeychain festgelegt ist.

signingProvisioningProfileID - Bereitstellungsprofil-UUID
Eingabealias: provProfileUuid. string. Optional. Verwenden Sie , wenn signMethod = id.

Gibt die UUID eines installierten Bereitstellungsprofils an, das für diesen Build verwendet werden soll.

signingP12File - P12-Zertifikatdatei
Eingabealias: p12. string. Optional. Verwenden Sie , wenn signMethod = file.

Gibt den relativen Pfad zu einer PKCS12-formatierten P12-Zertifikatdatei an, die ein Signaturzertifikat enthält, das für diesen Build verwendet werden soll.

signingP12Password - P12-Kennwort
Eingabealias: p12pwd. string. Optional. Verwenden Sie , wenn signMethod = file.

Gibt das Kennwort für die P12-Zertifikatdatei an. Verwenden Sie eine Buildvariable, um diesen Wert zu verschlüsseln.

signingProvisioningProfileFile - Bereitstellungsprofildatei
Eingabealias: provProfile. string. Optional. Verwenden Sie , wenn signMethod = file.

Gibt die UUID eines installierten Bereitstellungsprofils an, das für diesen Build verwendet werden soll.

signingRemoveProfile - Profil nach dem Build entfernen
Eingabealias: removeProfile. boolean. Optional. Verwenden Sie , wenn signMethod = file. Standardwert. false.

Gibt an, dass der Inhalt der Bereitstellungsprofildatei nach Abschluss des Builds aus dem Build-Agent entfernt werden soll. Aktivieren Sie dies nur, wenn Sie einen Agent pro Benutzer ausführen.

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keine

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
Einstellbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Entwickeln

Freigeben über