Xcode@3 - Xcode Build v3-taak

Gebruik deze taak om een Xcode-werkruimte te bouwen in macOS.

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.

Invoerwaarden

actions - Acties
string. Vereist. Standaardwaarde: build.

Hiermee geeft u een door spaties gescheiden lijst met acties op. Geldige opties zijn build, clean, test, analyzeen archive. Bijvoorbeeld: build clean voert een schone build uit. Zie apple: bouwen vanaf de opdrachtregel met veelgestelde vragen over Xcode.

configuration - Configuratie
string. Standaardwaarde: $(Configuration).

Hiermee geeft u het Xcode-project of de werkruimteconfiguratie te bouwen. Wanneer u een variabele gebruikt, geeft u een waarde op (bijvoorbeeld Release) op het tabblad Variabelen .

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

Hiermee bouwt u een Xcode-project of -werkruimte op basis van de opgegeven SDK. Voer uit xcodebuild -showsdks om een geldige lijst met SDK's weer te geven.

xcWorkspacePath - Werkruimte/projectpad
string. Standaardwaarde: **/*.xcodeproj/*.xcworkspace.

Optioneel. Hiermee geeft u het relatieve pad van de opslagplaatshoofdmap naar de Xcode-werkruimte of het project. Bijvoorbeeld: MyApp/MyApp.xcworkspace of MyApp/MyApp.xcworkspace/MyApp.xcodeproj. Laat leeg als u wilt gebruiken -target flag onder Geavanceerde argumenten.

scheme - Regeling
string.

Optioneel. Hiermee geeft u de naam van het Xcode-schema op. Moet een gedeeld schema zijn (gedeeld selectievakje onder Beheerde schema's in Xcode). Vereist als Werkruimte is opgegeven.

packageApp - App-pakket maken
boolean. Standaardwaarde: true.

Hiermee geeft u op of een IPA wordt gegenereerd als onderdeel van de build. Als u archieven met Xcode 7 en Xcode 8 wilt exporteren, raadpleegt u aanvullende invoer in de sectie Pakketopties .

archivePath - Archiefpad
string.

Optioneel. Hiermee geeft u een map op waar gemaakte archieven worden geplaatst.

exportPath - Exportpad
string. Standaardwaarde: output/$(SDK)/$(Configuration).

Optioneel. Hiermee geeft u de bestemming voor het product geëxporteerd uit het archief.

exportOptions - Exportopties
string. Toegestane waarden: auto, plist, specify. Standaardwaarde: auto.

Hiermee geeft u een manier op om door te geven in Exportopties bij het exporteren van het archief.

exportMethod - Exportmethode
string. Vereist wanneer exportOptions == specify. Standaardwaarde: development.

Hiermee geeft u de methode Xcode gebruikt om het archief te exporteren. Bijvoorbeeld , app-storepackage, ad-hoc, enterpriseof development.

exportTeamId - Team-id
string. Optioneel. Gebruik wanneer exportOptions == specify.

Hiermee geeft u de 10-cijferige team-id van de Apple Developer Portal op die moet worden gebruikt voor de export.

exportOptionsPlist - Plist exportopties
string. Vereist wanneer exportOptions == plist.

Hiermee geeft u het pad naar een plist-bestand waarmee archiefexport wordt geconfigureerd.

exportArgs - Argumenten exporteren
string.

Hiermee geeft u aanvullende opdrachtregelargumenten die worden gebruikt om te exporteren.

xcode8AutomaticSigning - Automatische ondertekening
boolean. Standaardwaarde: false.

Gebruik deze invoer als u een Xcode 8- of Xcode 9-project hebt geconfigureerd voor Automatische ondertekening.

teamId - Team-id
string. Optioneel. Gebruik wanneer xcode8AutomaticSigning = true.

Hiermee geeft u de 10-cijferige ontwikkelaarsteam-id op. Dit is vereist als u lid bent van meerdere ontwikkelteams.

signMethod - Overschrijven met
string. Toegestane waarden: file (Bestandsinhoud), id (Id's). Standaardwaarde: file.

Gebruik deze invoer als in de build een ondertekenings- of inrichtingsmethode wordt gebruikt die anders is dan de standaardmethode. Kies ervoor File Contents om een P12-certificaat en inrichtingsprofiel te gebruiken. Kies ervoor Identifiers om ondertekeningsinstellingen op te halen uit de standaardsleutelhanger en vooraf geïnstalleerde profielen. Laat de bijbehorende velden leeg als u de standaardinstellingen voor de build niet wilt overschrijven.

iosSigningIdentity - Ondertekeningsidentiteit
string. Optioneel. Gebruik wanneer signMethod = id.

Hiermee geeft u de ondertekeningsidentiteit op die wordt gebruikt om de build te ondertekenen. Standaard ingesteld op de projectinstelling Xcode. Standaardsleutelhanger ontgrendelen moet mogelijk worden geselecteerd.

unlockDefaultKeychain - Standaardsleutelhanger ontgrendelen
boolean. Optioneel. Gebruik wanneer signMethod = id. Standaardwaarde: false.

Lost fouten met gebruikersinteractie is niet toegestaan op door de standaardsleutelhanger te ontgrendelen.

defaultKeychainPassword - Standaardsleutelhangerwachtwoord
string. Optioneel. Gebruik wanneer signMethod = id.

Hiermee geeft u het wachtwoord voor het ontgrendelen van de standaardsleutelhanger.

provProfileUuid - UUID van inrichtingsprofiel
string. Optioneel. Gebruik wanneer signMethod = id.

Hiermee geeft u de UUID van een geïnstalleerd inrichtingsprofiel te gebruiken voor de build. Gebruik afzonderlijke buildtaken met verschillende schema's of doelen om inrichtingsprofielen per doel op te geven in één werkruimte (iOS, WatchKit, tvOS).

p12 - P12-certificaatbestand
string. Optioneel. Gebruik wanneer signMethod = file.

Hiermee geeft u het relatieve pad naar een P12-certificaatbestand met PKCS12-indeling dat een handtekeningcertificaat bevat dat moet worden gebruikt voor de build.

p12pwd - P12-wachtwoord
string. Optioneel. Gebruik wanneer signMethod = file.

Hiermee geeft u het wachtwoord voor een P12-certificaatbestand. Gebruik een buildvariabele om te versleutelen.

provProfile - Inrichtingsprofielbestand
string. Optioneel. Gebruik wanneer signMethod = file.

Hiermee geeft u het relatieve pad op naar een bestand met een overschrijving van een inrichtingsprofiel dat moet worden gebruikt voor de build. Gebruik afzonderlijke buildtaken met verschillende schema's of doelen om inrichtingsprofielen per doel op te geven in één werkruimte (iOS, WatchKit, tvOS).

removeProfile - Profiel verwijderen na build
boolean. Optioneel. Gebruik wanneer signMethod = file. Standaardwaarde: false.

Hiermee verwijdert u de inhoud van het inrichtingsprofielbestand uit de buildagent nadat de build is voltooid. Controleer alleen of u één agent per gebruiker uitvoert.

args - Argumenten
string.

Hiermee geeft u aanvullende opdrachtregelargumenten op die worden gebruikt om te bouwen. Deze invoer is handig als u of -project wilt gebruiken -target in plaats van een werkruimte en schema op te geven.

cwd - Werkmap
string.

Hiermee geeft u de werkmap voor build-uitvoeringen. Standaard ingesteld op de hoofdmap van de opslagplaats.

outputPattern - Uitvoermap
string. Vereist. Standaardwaarde: output/$(SDK)/$(Configuration).

Hiermee geeft u het relatieve pad op waar build-uitvoer (binaire bestanden) wordt geplaatst.

xcodeDeveloperDir - Xcode-ontwikkelaarspad
string.

Optioneel. Hiermee geeft u het pad naar de Xcode Developer-map op als dit niet de standaardinstelling van het systeem is. Voor gebruik wanneer meerdere versies van Xcode op een systeem zijn geïnstalleerd. Bijvoorbeeld: /Applications/Xcode 7.app/Contents/Developer.

useXcpretty - xcpretty gebruiken
boolean. Standaardwaarde: false.

Hiermee wordt xcodebuild de uitvoer opgemaakt en wordt een rapport met JUnit-testresultaten gegenereerd. Moet worden geïnstalleerd op agenthosts. Meer informatie over xcpretty.

publishJUnitResults - Publiceren naar VSTS/TFS
boolean. Standaardwaarde: false.

JUnit-testresultaten die zijn geproduceerd met behulp van xctool , worden gepubliceerd naar VSTS/TFS.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die deze taak gebruiken: xcode
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Build