Freigeben über


Xcode@3 – Xcode Build v3-Aufgabe

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.

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. Beispiel: build clean Führt 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 .


archivePath - Archivpfad
string.

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


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

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


exportOptions - Exportoptionen
string. 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.


exportArgs - Exportieren von Argumenten
string.

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


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 Buildaufgaben mit verschiedenen 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 PKCS12-formatierten P12-Zertifikatdatei 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. 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 ein Bereitstellungsprofil außer Kraft setzt, das für den Build verwendet werden soll. Verwenden Sie separate Buildaufgaben mit verschiedenen Schemas oder Zielen, um Bereitstellungsprofile nach Ziel in einem einzelnen Arbeitsbereich (iOS, WatchKit, tvOS) anzugeben.


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

Entfernt den Inhalt der Bereitstellungsprofildatei aus dem Build-Agent, nachdem der Buildvorgang 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 er nicht der Systemstandard ist. 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 xcodebuild die 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.


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