Xcode@2 - Xcode Build v2-taak

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

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.

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. Voert bijvoorbeeld build clean 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 op die moet worden gebouwd. 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 Xcode-project. Bijvoorbeeld: MyApp/MyApp.xcworkspace of MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Laat leeg als u van plan bent te gebruiken -target flag onder Geavanceerde argumenten.

scheme - Regeling
string.

Optioneel. Hiermee geeft u de naam van het Xcode-schema. 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 wilt exporteren met Xcode 7 en Xcode 8, bekijkt u aanvullende invoer in de sectie Pakketopties .

packageTool - Create Package (IPA) met behulp van
string. Vereist. Toegestane waarden: xcrun (xcrun (afgeschaft door Apple)), xcodebuild (xcodebuild archive and export). Standaardwaarde: xcodebuild.

Hiermee geeft u het hulpprogramma te gebruiken voor het genereren van de IPA.

archivePath - Archiefpad
string. Optioneel. Gebruik wanneer packageTool == xcodebuild.

Hiermee geeft u een map op waarin gemaakte archieven worden geplaatst.

exportPath - Exportpad
string. Optioneel. Gebruik wanneer packageTool == xcodebuild. Standaardwaarde: output/$(SDK)/$(Configuration).

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

exportOptions - Exportopties
string. Optioneel. Gebruik wanneer packageTool == xcodebuild. Toegestane waarden: auto, plist, specify. Standaardwaarde: auto.

Hiermee geeft u een manier op om exportopties door te geven 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 - Exportopties Plist
string. Vereist wanneer exportOptions == plist.

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

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 team-id voor ontwikkelaars 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 de build een ondertekenings- of inrichtingsmethode 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 standaard build-instellingen niet wilt overschrijven.

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

Hiermee geeft u de onderdrukking van 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 op indien opgegeven. 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.

useXctool - xctool gebruiken
boolean.

Gebruikt xctool in plaats van xcodebuild. Moet worden geïnstalleerd op agenthosts. Meer informatie over xctool.
Opmerking:xctool is afgeschaft en werkt niet met Xcode 8.

xctoolReporter - xctool Test Reporter Format
string.

Test de indeling van de reporter die moet worden gebruikt wanneer de testactie is opgegeven en xctool gebruiken is ingeschakeld. Geef junit:output-file-path-here.xml op om een bestandsindeling te genereren die compatibel is met de taak Testresultaten publiceren. Wanneer u dit opgeeft, wordt plain automatisch toegevoegd. xctool moet worden geïnstalleerd op agenthosts. Meer informatie over xctool.
Opmerking:xctool is afgeschaft en werkt niet met Xcode 8.

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