Xcode@3 – Xcode Build v3-Aufgabe

Artikel
03/24/2025

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

Syntax

# Xcode Build v3
# Build an Xcode workspace on macOS.
- task: Xcode@3
  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
    #archivePath: # string. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. 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. Export Arguments. 
  # 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.

Eingänge

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. Beispiel: build clean führt einen sauberen Build aus. Siehe Apple: Erstellen über die Befehlszeile mit Xcode FAQ.

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

Gibt die zu erstellende Xcode-Projekt- oder Arbeitsbereichskonfiguration an. Geben Sie bei Verwendung einer Variablen einen Wert (z. B. Release) auf der Registerkarte Variablen an.

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

Erstellt ein Xcode-Projekt oder einen Arbeitsbereich mit dem angegebenen SDK. Führen Sie xcodebuild -showsdks aus, um eine gültige Liste der SDKs anzuzeigen.

xcWorkspacePath - Arbeitsbereich/Projektpfad
string. Standardwert: **/*.xcodeproj/*.xcworkspace.

Wahlfrei. Gibt den relativen Pfad vom Repositorystamm zum Xcode-Arbeitsbereich oder -Projekt an. Beispiel: MyApp/MyApp.xcworkspace oder MyApp/MyApp.xcworkspace/MyApp.xcodeproj. Lassen Sie leer, wenn Sie -target flag unter erweiterten Argumenteverwenden möchten.

scheme - Schema-
string.

Wahlfrei. Gibt den Xcode-Schemanamen an. Muss ein freigegebenes Schema sein (freigegebenes Kontrollkästchen unter verwalteten Schemas in Xcode). Erforderlich, wenn Arbeitsbereich angegeben ist.

packageApp - Erstellen von App-Paket-
boolean. Standardwert: true.

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

archivePath - Archivpfad
string.

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

exportPath - Exportpfad
string. Standardwert: output/$(SDK)/$(Configuration).

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

exportOptions - Exportoptionen
string. Zulässige Werte: auto, plist, specify. Standardwert: auto.

Gibt eine Möglichkeit zum Übergeben Exportoptionen beim Exportieren des Archivs an.

exportMethod - Export-Methode
string. Erforderlich, wenn exportOptions == specify. Standardwert: development.

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

exportTeamId - Team-ID
string. Wahlfrei. Wird verwendet, wenn exportOptions == specify.

Gibt die 10-stellige Team-ID des Apple Developer Portals an, die für den Export verwendet werden soll.

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

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

exportArgs - Exportieren von Argumenten
string.

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

xcode8AutomaticSigning - automatische Signierung
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. Wahlfrei. Wird verwendet, wenn xcode8AutomaticSigning = true.

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

signMethod - Mithilfe von außer Kraft setzen
string. Zulässige Werte: file (Dateiinhalte), 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, um ein P12-Zertifikat und ein Bereitstellungsprofil zu verwenden. Wählen Sie Identifiers aus, 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.

iosSigningIdentity - Signierungsidentität
string. Wahlfrei. Wird verwendet, wenn signMethod = id.

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

unlockDefaultKeychain - Entsperren der Standardschlüsselbund-
boolean. Wahlfrei. Wird verwendet, wenn signMethod = id. Standardwert: false.

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

defaultKeychainPassword - Standardschlüsselbundkennwort-
string. Wahlfrei. Wird verwendet, wenn signMethod = id.

Gibt das Kennwort an, mit dem der Standardschlüsselbund entsperrt werden soll.

provProfileUuid - Bereitstellungsprofil-UUID-
string. Wahlfrei. Wird verwendet, wenn signMethod = id.

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

p12 - P12-Zertifikatdatei
string. Wahlfrei. Wird verwendet, wenn signMethod = file.

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

p12pwd - P12 Password
string. Wahlfrei. Wird verwendet, wenn signMethod = file.

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

provProfile - Bereitstellungsprofildatei
string. Wahlfrei. Wird verwendet, 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 Buildaufgaben mit verschiedenen Schemas oder Zielen, um Bereitstellungsprofile nach Ziel in einem einzigen Arbeitsbereich (iOS, WatchKit, tvOS) anzugeben.

removeProfile - Profil nach dem Build- entfernen
boolean. Wahlfrei. Wird verwendet, wenn signMethod = file. Standardwert: false.

Entfernt den Inhalt der Bereitstellungsprofildatei aus dem Build-Agent, nachdem der Build abgeschlossen ist. Nur überprüfen, 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 -target oder -project verwenden möchten, anstatt einen Arbeitsbereich und ein Schema anzugeben.

cwd - Arbeitsverzeichnis-
string.

Gibt das Arbeitsverzeichnis für Buildausführungen an. Der Standardwert ist das Stammverzeichnis des Repositorys.

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

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

xcodeDeveloperDir - Xcode Developer Path
string.

Wahlfrei. Gibt den Pfad zum Ordner "Xcode Developer" 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 - Xcpretty- verwenden
boolean. Standardwert: false.

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

publishJUnitResults - In VSTS/TFS veröffentlichen
boolean. Standardwert: false.

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

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
Läuft auf	Agent, DeploymentGroup
Anforderungen	Self-hosted agents must have capabilities that match the following anforderungen to run jobs that use this task: xcode:
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	Alle unterstützten Agentversionen.
Vorgangskategorie	Bauen

Freigeben über