Xcode@2 – Xcode Build v2-Aufgabe

Verwenden Sie diese Aufgabe, um einen Xcode-Arbeitsbereich unter macOS zu erstellen.

Syntax

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

Eingaben

actions - Aktionen
string. Erforderlich. Standardwert. build.

Gibt eine durch Leerzeichen getrennte Liste von Aktionen an. Gültige Optionen sind build, clean, test, analyze und archive. Führt beispielsweise build clean einen sauber Build aus. Weitere Informationen finden Sie unter Apple: Erstellen über die Befehlszeile mit Xcode FAQ.

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).

Erstellt ein Xcode-Projekt oder einen Xcode-Arbeitsbereich für das angegebene SDK. Führen Sie aus xcodebuild -showsdks , um eine gültige Liste von SDKs anzuzeigen.

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

Optional. Gibt den relativen Pfad vom Repositorystamm zum Xcode-Arbeitsbereich oder -Projekt an. Zum Beispiel: MyApp/MyApp.xcworkspace oder MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Lassen Sie leer, wenn Sie unter Erweiterte Argumente verwenden -target flag möchten.

scheme - Schema
string.

Optional. Gibt den Namen des Xcode-Schemas an. Muss ein freigegebenes Schema sein (Kontrollkästchen freigegeben unter Verwaltete Schemas in Xcode). Erforderlich, wenn Arbeitsbereich angegeben ist.

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

Gibt an, ob ein IPA als Teil des Builds generiert wird. Informationen zum Exportieren von Archiven mit Xcode 7 und Xcode 8 finden Sie im Abschnitt Paketoptionen .

packageTool - Erstellen eines Pakets (IPA) mit
string. Erforderlich. Zulässige Werte: xcrun (xcrun (von Apple veraltet)), xcodebuild (xcodebuild archiv and export). Standardwert. xcodebuild.

Gibt das Tool an, das zum Generieren des IPA verwendet werden soll.

archivePath - Archivpfad
string. Optional. Verwenden Sie , wenn packageTool == xcodebuild.

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

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

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

exportOptions - Exportoptionen
string. Optional. Verwenden Sie , wenn packageTool == xcodebuild. Zulässige Werte: auto, plist und specify. Standardwert. auto.

Gibt eine Möglichkeit an, beim Exportieren des Archivs in Exportoptionen zu übergeben.

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

Gibt die Methode an, die Xcode zum Exportieren des Archivs verwendet. 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 für das Apple Developer Portal an, die für den Export verwendet werden soll.

exportOptionsPlist - Plist für Exportoptionen
string. Erforderlich, wenn exportOptions == plist.

Gibt den Pfad zu einer plist-Datei an, die den Archivexport konfiguriert.

xcode8AutomaticSigning - Automatische Signatur
boolean. Standardwert. false.

Verwenden Sie diese Eingabe, wenn Sie ein Xcode 8- oder Xcode 9-Projekt für die automatische Signatur konfiguriert haben.

teamId - Team-ID
string. Optional. Verwenden Sie , wenn xcode8AutomaticSigning = true.

Gibt die 10-stellige Entwicklerteam-ID an. Diese ist erforderlich, wenn Sie Mitglied mehrerer Entwicklungsteams sind.

signMethod - Überschreiben mit
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 Contents aus, ob Sie ein P12-Zertifikat und ein Bereitstellungsprofil verwenden möchten. Wählen Sie ausIdentifiers, um Signatureinstellungen aus den Standardprofilen Keychain und vorinstallierten Profilen abzurufen. Lassen Sie die entsprechenden Felder leer, wenn Sie die Standardbuildeinstellungen nicht außer Kraft setzen möchten.

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

Gibt die Signaturidentitätsüberschreibung an, die zum Signieren des Builds verwendet wird. Standardmäßig wird die Xcode-Projekteinstellung verwendet. Standardschlüsselbund entsperren muss möglicherweise ausgewählt werden.

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

Behebt Fehler bei Benutzerinteraktionen sind nicht zulässig, indem die Standard-Keychain entsperrt wird.

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

Gibt das Kennwort zum Entsperren der Standard-Keychain an.

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

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

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

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

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

Gibt das Kennwort für eine P12-Zertifikatdatei an, falls angegeben. Verwenden Sie eine Buildvariable zum Verschlüsseln.

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

Gibt den relativen Pfad zu einer Datei an, die eine Bereitstellungsprofilüberschreibung enthält, die für den Build verwendet werden soll. Verwenden Sie separate Buildtasks mit unterschiedlichen Schemas oder Zielen, um Bereitstellungsprofile nach Ziel in einem einzelnen Arbeitsbereich (iOS, WatchKit, tvOS) anzugeben.

removeProfile - Entfernen des Profils nach dem Build
boolean. Optional. Verwenden Sie , wenn signMethod = file. Standardwert. false.

Entfernt den Inhalt der Bereitstellungsprofildatei aus dem Build-Agent, nachdem der Build abgeschlossen ist. Überprüfen Sie nur, ob Sie einen Agent pro Benutzer ausführen.

args - Argumente
string.

Gibt zusätzliche Befehlszeilenargumente an, die zum Erstellen verwendet werden. Diese Eingabe ist nützlich, wenn Sie oder -project verwenden möchten-target, anstatt einen Arbeitsbereich und ein Schema anzugeben.

cwd - Arbeitsverzeichnis
string.

Gibt das Arbeitsverzeichnis für Buildausführungen an. Standardmäßig wird der Stamm des Repositorys verwendet.

outputPattern - Ausgabeverzeichnis
string. Erforderlich. Standardwert. output/$(SDK)/$(Configuration).

Gibt den relativen Pfad an, in dem die Buildausgabe (Binärdateien) platziert wird.

xcodeDeveloperDir - Xcode-Entwicklerpfad
string.

Optional. Gibt den Pfad zum Xcode Developer-Ordner an, wenn es sich nicht um den Systemstandard handelt. Zur Verwendung, wenn mehrere Versionen von Xcode auf einem System installiert sind. Beispiel: /Applications/Xcode 7.app/Contents/Developer.

useXcpretty - Verwenden von xcpretty
boolean. Standardwert. false.

Formatiert die xcodebuild Ausgabe und generiert einen JUnit-Testergebnisbericht. Muss auf Agenthosts installiert sein. Erfahren Sie mehr über xcpretty.

publishJUnitResults - Veröffentlichen in VSTS/TFS
boolean. Standardwert. false.

JUnit-Testergebnisse, die mit xctool erstellt wurden, werden in VSTS/TFS veröffentlicht.

useXctool - Verwenden von xctool
boolean.

Verwendet xctool anstelle von xcodebuild. Muss auf Agenthosts installiert sein. Erfahren Sie mehr über xctool.
Hinweis:xctool ist veraltet und funktioniert nicht mit Xcode 8.

xctoolReporter - xctool Test Reporter Format
string.

Testet das Reporterformat, das verwendet werden soll, wenn die Testaktion angegeben ist, und xctool verwenden ist aktiviert. Geben Sie an junit:output-file-path-here.xml , um ein Dateiformat zu generieren, das mit der Aufgabe Testergebnisse veröffentlichen kompatibel ist. Wenn angegeben, wird "plain" automatisch hinzugefügt. xctool muss auf Agenthosts installiert werden. Erfahren Sie mehr über xctool.
Hinweis:xctool ist veraltet und funktioniert nicht mit Xcode 8.

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.

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