Xcode@5 – Xcode v5-Aufgabe

Verwenden Sie diese Aufgabe, um einen Xcode-Arbeitsbereich unter macOS zu erstellen, zu testen oder zu archivieren und optional eine App zu packen.

Syntax

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

Eingaben

actions - Aktionen
string. Erforderlich. Standardwert. build.

Gibt eine durch Leerzeichen getrennte Liste von Aktionen an. Einige gültige Optionen sind build, clean, test, analyzeund archive. Führt beispielsweiseclean build einen sauber Build aus. Weitere Informationen finden Sie unter Apple: Erstellen über die Befehlszeile mit Xcode – Häufig gestellte Fragen.

configuration - Konfiguration
string. Standardwert. $(Configuration).

Gibt die zu erstellende Xcode-Projekt- oder Arbeitsbereichskonfiguration an. Wenn Sie eine Variable verwenden, geben Sie einen Wert (z. ReleaseB. ) auf der Registerkarte Variablen an .

sdk - SDK
string. Standardwert. $(SDK).

Gibt ein SDK an, das beim Erstellen des Xcode-Projekts oder -Arbeitsbereichs verwendet werden soll. Führen Sie in der macOS-Terminalanwendung aus xcodebuild -showsdks , um die gültige Liste der SDKs anzuzeigen. Wenn Sie eine Variable verwenden, geben Sie einen Wert (z. iphonesimulatorB. ) auf der Registerkarte Variablen an .

xcWorkspacePath - Arbeitsbereichs- oder Projektpfad
string. Standardwert. **/*.xcodeproj/project.xcworkspace.

Optional. Gibt einen relativen Pfad vom Stamm des Repositorys zum Xcode-Arbeitsbereich oder -Projekt an. Zum Beispiel: MyApp/MyApp.xcworkspace oder MyApp/MyApp.xcodeproj. Platzhalter können verwendet werden. Erfahren Sie mehr über Dateiabgleichsmuster.

scheme - Schema
string.

Optional. Gibt einen Xcode-Schemanamen an. Muss ein freigegebenes Schema sein (Kontrollkästchen freigegeben unter Verwaltete Schemas in Xcode). Wenn Sie kein Schema angeben und der angegebene Arbeitsbereich über ein einzelnes freigegebenes Schema verfügt, wird das Arbeitsbereichsschema verwendet.

xcodeVersion - Xcode-Version
string. Zulässige Werte: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Pfad angeben). Standardwert. default.

Gibt die Zielversion von Xcode an. Wählen Sie aus Default , um die Standardversion von Xcode auf dem Agentcomputer zu verwenden. Die Angabe einer Versionsnummer (z. B. ) basiert auf dem Speicherort der Version, Xcode 9XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developerder durch Umgebungsvariablen auf dem Agentcomputer festgelegt werden soll (z. B. ). Wählen Sie diese Option aus Specify path , um einen bestimmten Pfad zum Xcode-Entwicklerverzeichnis anzugeben.

xcodeDeveloperDir - Xcode-Entwicklerpfad
string. Optional. Verwenden Sie , wenn xcodeVersion == specifyPath.

Gibt einen Pfad zu einem bestimmten Xcode-Entwicklerverzeichnis an (z. B /Applications/Xcode_9.0.0.app/Contents/Developer. ). Diese Eingabe ist nützlich, wenn mehrere Versionen von Xcode auf dem Agent-Computer installiert sind.

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

Gibt an, ob eine IPA-App-Paketdatei als Teil des Builds generiert wird.

archivePath - Archivpfad
string. Optional. Verwenden Sie , wenn packageApp == true.

Gibt ein Verzeichnis an, in dem erstellte Archive platziert werden.

exportPath - Exportpfad
string. Optional. Verwenden Sie , wenn packageApp == true. Standardwert. output/$(SDK)/$(Configuration).

Gibt das Ziel für das aus dem Archiv exportierte Produkt an.

exportOptions - Exportoptionen
string. Optional. Verwenden Sie , wenn packageApp == true. Zulässige Werte: auto (Automatisch), plist, specify. Standardwert. auto.

Gibt Optionen zum Exportieren des Archivs an. Wenn der Standardwert von Automatic ausgewählt ist, wird die Exportmethode automatisch aus dem Archiv erkannt. Wählen Sie diese Option aus Plist , um eine plist-Datei mit Exportoptionen anzugeben. Wählen Sie diese Option aus Specify , um eine bestimmte Exportmethode und team-ID anzugeben.

exportMethod - Exportmethode
string. Erforderlich, wenn exportOptions == specify. Standardwert. development.

Gibt die Methode an, die Xcode zum Exportieren des Archivs verwendet. Zum Beispiel: app-store, package, ad-hoc, enterprise oder development.

exportTeamId - Team-ID
string. Optional. Verwenden Sie , wenn exportOptions == specify.

Gibt die 10-stellige Team-ID des Apple Developer Portal an, die während des Exports verwendet werden soll.

exportOptionsPlist - Exportoptionen plist
string. Erforderlich, wenn exportOptions == plist.

Gibt den Pfad zur plist-Datei an, die Optionen enthält, die während des Exports verwendet werden sollen.

exportArgs - Exportieren von Argumenten
string. Optional. Verwenden Sie , wenn packageApp == true.

Gibt zusätzliche Befehlszeilenargumente an, die beim Export verwendet werden.

signingOption - Signaturstil
string. Zulässige Werte: nosign (Kein Codezeichen), default (Project-Standardwerte), manual (Manuelle Signatur), auto (Automatische Signatur). Standardwert. nosign.

Gibt die Methode zum Signieren des Builds an. Wählen Sie diese Option aus Do not code sign , um die Signatur zu deaktivieren. Wählen Sie aus Project defaults , um nur die Signaturkonfiguration des Projekts zu verwenden. Wählen Sie diese Option aus Manual signing , um die manuelle Signatur zu erzwingen, und geben Sie optional eine Signaturidentität und ein Bereitstellungsprofil an. Wählen Sie diese Option aus Automatic signing , um die automatische Signatur zu erzwingen, und geben Sie optional eine Entwicklungsteam-ID an. Wenn Für Ihr Projekt eine Signatur erforderlich ist, verwenden Sie die Aufgaben Apple installieren... zum Installieren von Zertifikaten und Bereitstellungsprofilen vor dem Xcode-Build.

signingIdentity - Signaturidentität
string. Optional. Verwenden Sie , wenn signingOption = manual.

Gibt eine Signaturidentitätsüberschreibung an, mit der der Build signiert werden soll. Das Entsperren der Standard-Keychain auf dem Agentcomputer ist möglicherweise erforderlich. Wenn kein Wert eingegeben wird, wird die Einstellung des Xcode-Projekts verwendet.

provisioningProfileUuid - UUID des Bereitstellungsprofils
string. Optional. Verwenden Sie , wenn signingOption = manual.

Gibt die UUID eines installierten Bereitstellungsprofils an, das für den Build verwendet wird. Verwenden Sie separate Buildtasks mit unterschiedlichen Schemas oder Zielen, um Bereitstellungsprofile nach Ziel in einem einzelnen Arbeitsbereich (iOS, tvOS, watchOS) anzugeben.

provisioningProfileName - Name des Bereitstellungsprofils
string. Optional. Verwenden Sie , wenn signingOption = manual.

Gibt den Namen eines installierten Bereitstellungsprofils an, das für den Build verwendet wird. Wenn angegeben, hat dies Vorrang vor der UUID des Bereitstellungsprofils. Verwenden Sie separate Buildtasks mit unterschiedlichen Schemas oder Zielen, um Bereitstellungsprofile nach Ziel in einem einzelnen Arbeitsbereich (iOS, tvOS, watchOS) anzugeben.

teamId - Team-ID
string. Optional. Verwenden Sie , wenn signingOption = auto.

Erforderlich, wenn Sie Mitglied mehrerer Entwicklungsteams sind. Gibt die 10-stellige Entwicklungsteam-ID an.

destinationPlatformOption - Zielplattform
string. Zulässige Werte: default, iOS (iOS und watchOS), tvOS, macOS, custom. Standardwert. default.

Gibt die Plattform des Zielgeräts an, die für Benutzeroberflächentests verwendet wird, wenn das generische Buildgerät ungültig ist. Wählen Sie Custom aus, um eine Plattform anzugeben, die nicht in dieser Liste enthalten ist. Wenn Default ausgewählt ist, werden keine Simulatoren oder Geräte als Ziel verwendet.

destinationPlatform - Benutzerdefinierte Zielplattform
string. Optional. Verwenden Sie , wenn destinationPlatformOption == custom.

Gibt die Plattform eines Zielgeräts an, die für Benutzeroberflächentests verwendet wird, wenn das generische Buildgerät ungültig ist. Wählen Sie Custom aus, um eine Plattform anzugeben, die nicht in der Liste enthalten ist. Wenn Default ausgewählt ist, werden keine Simulatoren oder Geräte als Ziel verwendet.

destinationTypeOption - Zieltyp
string. Optional. Verwenden Sie , wenn destinationPlatformOption != default && destinationPlatformOption != macOS. Zulässige Werte: simulators (Simulator), devices (Verbundenes Gerät). Standardwert. simulators.

Gibt den Zieltyp an, der für Benutzeroberflächentests verwendet werden soll. Geräte müssen über eine Kabel- oder Netzwerkverbindung mit dem Mac verbunden sein, der den Build ausführt. Weitere Informationen finden Sie unter Geräte und Simulatoren in Xcode.

destinationSimulators - Simulator
string. Optional. Verwenden Sie , wenn destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Gibt einen Xcode-Simulatornamen an, der für Benutzeroberflächentests verwendet wird. Beispiel iPhone X : (iOS und watchOS) oder Apple TV 4K (tvOS). Eine optionale Zielbetriebssystemversion kann im Format OS=<versionNumber>angegeben werden, z iPhone X,OS=11.1. B. . Weitere Informationen finden Sie in dieser Liste der simulatoren, die auf dem gehosteten macOS-Agent installiert sind .

destinationDevices - Gerät
string. Optional. Verwenden Sie , wenn destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Gibt den Namen des Geräts an, das für Benutzeroberflächentests verwendet wird, z Raisa's iPad. B. . Derzeit wird nur ein Gerät unterstützt. Beachten Sie, dass Apple keine Apostrophe (') in Gerätenamen zulässt. Stattdessen können rechte einfache Anführungszeichen (') verwendet werden.

args - Argumente
string.

Optional. Gibt zusätzliche Befehlszeilenargumente an, mit denen erstellt werden soll. Diese Eingabe ist nützlich, um Argumente oder -project anstelle eines Arbeitsbereichs/Projekts und Schemas anzugeben-target. Weitere Informationen finden Sie unter Apple: Häufig gestellte Fragen zum Erstellen über die Befehlszeile mit Xcode.

workingDirectory - Arbeitsverzeichnis
Eingabealias: cwd. string.

Optional. Gibt das Arbeitsverzeichnis an, in dem der Build ausgeführt werden soll. Wenn kein Wert eingegeben wird, wird der Stamm des Repositorys verwendet.

useXcpretty - Verwenden von xcpretty
boolean. Standardwert. true.

Gibt an, ob zum Formatieren xcodebuild der Ausgabe verwendet xcpretty werden soll. xcpretty muss auf dem Agent-Computer installiert sein (er ist auf von Azure Pipelines gehosteten Build-Agents vorinstalliert). Wenn xcpretty nicht installiert ist, wird die Unformatierte xcodebuild Ausgabe angezeigt. Weitere Informationen finden Sie unter xcpretty .

xcprettyArgs - Xcpretty-Argumente
string. Optional. Verwenden Sie , wenn useXcpretty == true.

Wenn xcpretty aktiviert ist, gibt diese Eingabe Argumente für xcprettyan. Eine Liste mit xcpretty-Argumenten finden Sie auf GitHub.

publishJUnitResults - Veröffentlichen von Testergebnissen in Azure Pipelines
boolean. Standardwert. false.

Gibt an, ob JUnit-Testergebnisse in Azure Pipelines veröffentlicht werden sollen. Dies muss xcpretty aktiviert sein, um JUnit-Testergebnisse zu generieren.

testRunTitle - Titel der Testausführung
string. Optional. Verwenden Sie , wenn publishJUnitResults == true.

Wenn xcpretty und publishJUnitResults aktiviert sind, können Sie den Testlauftitel angeben.

Optionen für die Vorgangskontrolle

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

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe, um einen Xcode-Arbeitsbereich unter macOS zu erstellen, zu testen oder zu archivieren und optional eine App zu packen.

Verwenden mehrerer Bereitstellungsprofile

Derzeit gibt es keine Unterstützung für mehrere Bereitstellungsprofile für den Xcode-Task (z. B. für die iOS-App-Erweiterung).

Beispiele

Erstellen Ihrer Xcode-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: xcode
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