Xcode@5 - Xcode v5-taak

Gebruik deze taak om een Xcode-werkruimte in macOS te bouwen, te testen of te archiveren en eventueel een app te verpakken.

Syntaxis

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. 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. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

Invoer

actions - acties
string. Verplicht. Standaardwaarde: build.

Hiermee geeft u een door spaties gescheiden lijst met acties op. Sommige geldige opties zijn build, clean, test, analyzeen archive. clean build voert bijvoorbeeld een schone build uit. Zie Apple: Bouwen vanaf de opdrachtregel met Xcode FAQ.

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

Hiermee geeft u de Xcode-project- of 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 geeft u een SDK op die moet worden gebruikt bij het bouwen van het Xcode-project of de werkruimte. Voer vanuit de macOS Terminal-toepassing xcodebuild -showsdks uit om de geldige lijst met SDK's weer te geven. Wanneer u een variabele gebruikt, geeft u een waarde op (bijvoorbeeld iphonesimulator) op het tabblad Variabelen.

xcWorkspacePath - werkruimte of projectpad
string. Standaardwaarde: **/*.xcodeproj/project.xcworkspace.

Facultatief. Hiermee geeft u een relatief pad van de hoofdmap van de opslagplaats naar de Xcode-werkruimte of -project. Bijvoorbeeld MyApp/MyApp.xcworkspace of MyApp/MyApp.xcodeproj. U kunt jokertekens gebruiken. Meer informatie over bestandskoppelingspatronen.

scheme -
string.

Facultatief. Hiermee geeft u een Xcode-schemanaam. Moet een gedeeld schema zijn (gedeeld selectievakje onder Beheerde schema's in Xcode). Als u geen schema opgeeft en de opgegeven werkruimte één gedeeld schema heeft, wordt het werkruimteschema gebruikt.

xcodeVersion - Xcode-versie
string. Toegestane waarden: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Pad opgeven). Standaardwaarde: default.

Hiermee geeft u de doelversie van Xcode. Selecteer Default om de standaardversie van Xcode op de agentcomputer te gebruiken. Het opgeven van een versienummer (bijvoorbeeld Xcode 9) is afhankelijk van de locatie van de versie die moet worden ingesteld door omgevingsvariabelen op de agentcomputer (bijvoorbeeld XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Selecteer Specify path om een specifiek pad naar de Xcode-ontwikkelaarsmap op te geven.

xcodeDeveloperDir - Xcode-ontwikkelaarspad
string. Facultatief. Gebruiken wanneer xcodeVersion == specifyPath.

Hiermee geeft u een pad naar een specifieke Xcode-ontwikkelaarsmap (bijvoorbeeld /Applications/Xcode_9.0.0.app/Contents/Developer). Deze invoer is handig wanneer meerdere versies van Xcode op de agentcomputer zijn geïnstalleerd.

packageApp - app-pakket maken
boolean. Standaardwaarde: false.

Hiermee geeft u op of een IPA-app-pakketbestand wordt gegenereerd als onderdeel van de build.

archivePath - archiefpad
string. Facultatief. Gebruiken wanneer packageApp == true.

Hiermee geeft u een map waarin gemaakte archieven worden geplaatst.

exportPath - pad exporteren
string. Facultatief. Gebruiken wanneer packageApp == true. Standaardwaarde: output/$(SDK)/$(Configuration).

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

exportOptions - exportopties
string. Facultatief. Gebruiken wanneer packageApp == true. Toegestane waarden: auto (automatisch), plist, specify. Standaardwaarde: auto.

Hiermee geeft u opties voor het exporteren van het archief. Wanneer de standaardwaarde van Automatic is geselecteerd, wordt de exportmethode automatisch gedetecteerd vanuit het archief. Selecteer Plist om een plist-bestand met exportopties op te geven. Selecteer Specify om een specifieke Exportmethode op te geven en team-id.

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

Hiermee geeft u de methode op die door Xcode wordt gebruikt om het archief te exporteren. Bijvoorbeeld: , , , , app-storeof package. ad-hocenterprisedevelopment

exportTeamId - team-id
string. Facultatief. Gebruiken wanneer exportOptions == specify.

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

exportOptionsPlist - plist- exporteren
string. Vereist wanneer exportOptions == plist.

Hiermee geeft u het pad naar het plist-bestand dat opties bevat die tijdens de export moeten worden gebruikt.

exportArgs - argumenten exporteren
string. Facultatief. Gebruiken wanneer packageApp == true.

Hiermee geeft u aanvullende opdrachtregelargumenten op die tijdens de export worden gebruikt.

signingOption - handtekeningstijl
string. Toegestane waarden: nosign (geen codeteken), default (standaardinstellingen van Project), manual (handmatige ondertekening), auto (automatische ondertekening). Standaardwaarde: nosign.

Hiermee geeft u de methode voor het ondertekenen van de build. Selecteer Do not code sign om ondertekening uit te schakelen. Selecteer Project defaults om alleen de ondertekeningsconfiguratie van het project te gebruiken. Selecteer Manual signing om handmatige ondertekening af te dwingen en eventueel een handtekeningidentiteit en inrichtingsprofiel op te geven. Selecteer Automatic signing om automatische ondertekening af te dwingen en eventueel een ontwikkelingsteam-id op te geven. Als voor uw project ondertekening is vereist, gebruikt u de Apple installeren... taken om certificaten en inrichtingsprofielen te installeren vóór de Xcode-build.

signingIdentity - handtekeningidentiteit
string. Facultatief. Gebruiken wanneer signingOption = manual.

Hiermee geeft u een onderdrukking van de ondertekeningsidentiteit op waarmee de build moet worden ondertekend. Het ontgrendelen van de standaardsleutelhanger op de agentcomputer is mogelijk vereist. Als er geen waarde wordt ingevoerd, wordt de instelling van het Xcode-project gebruikt.

provisioningProfileUuid - UUID- voor inrichtingsprofiel
string. Facultatief. Gebruiken wanneer signingOption = manual.

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

provisioningProfileName - inrichtingsprofielnaam
string. Facultatief. Gebruiken wanneer signingOption = manual.

Hiermee geeft u de naam op van een geïnstalleerd inrichtingsprofiel dat wordt gebruikt voor de build. Indien opgegeven, heeft dit voorrang op de UUID van het inrichtingsprofiel. Gebruik afzonderlijke buildtaken met verschillende schema's of doelen om inrichtingsprofielen op te geven per doel in één werkruimte (iOS, tvOS, watchOS).

teamId - team-id
string. Facultatief. Gebruiken wanneer signingOption = auto.

Vereist als u lid bent van meerdere ontwikkelteams. Hiermee geeft u de ontwikkelingsteam-id van 10 tekens op.

destinationPlatformOption - doelplatform
string. Toegestane waarden: default, iOS (iOS en watchOS), tvOS, macOS, custom. Standaardwaarde: default.

Hiermee geeft u het platform van het doelapparaat op dat wordt gebruikt voor het testen van de gebruikersinterface wanneer het algemene buildapparaat niet geldig is. Kies Custom om een platform op te geven dat niet in deze lijst is opgenomen. Wanneer Default is geselecteerd, zijn er geen simulators of apparaten gericht.

destinationPlatform - aangepast doelplatform
string. Facultatief. Gebruiken wanneer destinationPlatformOption == custom.

Hiermee geeft u het platform van een doelapparaat op dat wordt gebruikt voor het testen van de gebruikersinterface wanneer het algemene buildapparaat niet geldig is. Kies Custom om een platform op te geven dat niet in de lijst is opgenomen. Wanneer Default is geselecteerd, zijn er geen simulatoren en apparaten gericht.

destinationTypeOption - doeltype
string. Facultatief. Gebruiken wanneer destinationPlatformOption != default && destinationPlatformOption != macOS. Toegestane waarden: simulators (simulator), devices (verbonden apparaat). Standaardwaarde: simulators.

Hiermee geeft u het doeltype op dat moet worden gebruikt voor het testen van de gebruikersinterface. Apparaten moeten zijn verbonden met de Mac die de build uitvoert via een kabel- of netwerkverbinding. Zie Apparaten en simulators in Xcode voor meer informatie.

destinationSimulators - Simulator
string. Facultatief. Gebruiken wanneer destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Hiermee geeft u een Xcode-simulatornaam op die wordt gebruikt voor het testen van de gebruikersinterface. Bijvoorbeeld iPhone X (iOS en watchOS) of Apple TV 4K (tvOS). Een optionele doelversie van het besturingssysteem kan worden opgegeven in de indeling OS=<versionNumber>, zoals iPhone X,OS=11.1. Zie deze lijst met simulators die zijn geïnstalleerd op de gehoste macOS--agent voor meer informatie.

destinationDevices - Device
string. Facultatief. Gebruiken wanneer destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Hiermee geeft u de naam op van het apparaat dat wordt gebruikt voor het testen van de gebruikersinterface, zoals Raisa's iPad. Er wordt momenteel slechts één apparaat ondersteund. Apple staat geen apostrofs (') toe in apparaatnamen. In plaats daarvan kunnen rechter enkele aanhalingstekens (') worden gebruikt.

args - argumenten
string.

Facultatief. Hiermee geeft u aanvullende opdrachtregelargumenten op waarmee moet worden gebouwd. Deze invoer is handig voor het opgeven van -target of -project argumenten in plaats van een werkruimte/project en schema. Zie Apple: Bouwen vanaf de opdrachtregel met Xcode FAQ.

workingDirectory - werkmap
Invoeralias: cwd. string.

Facultatief. Hiermee geeft u de werkmap waarin de build moet worden uitgevoerd. Als er geen waarde wordt ingevoerd, wordt de hoofdmap van de opslagplaats gebruikt.

useXcpretty - xcpretty- gebruiken
boolean. Standaardwaarde: true.

Hiermee geeft u op of xcpretty moet worden gebruikt om xcodebuild uitvoer op te maken. xcpretty moet worden geïnstalleerd op de agentcomputer (deze is vooraf geïnstalleerd op door Azure Pipelines gehoste buildagents). Als xcpretty niet is geïnstalleerd, wordt onbewerkte xcodebuild uitvoer weergegeven. Zie xcpretty- voor meer informatie.

xcprettyArgs - Xcpretty-argumenten
string. Facultatief. Gebruiken wanneer useXcpretty == true.

Als xcpretty is ingeschakeld, geeft deze invoer argumenten op voor xcpretty. Zie een lijst met xcpretty-argumenten op GitHub.

publishJUnitResults - Testresultaten publiceren naar Azure Pipelines
boolean. Standaardwaarde: false.

Hiermee geeft u op of JUnit-testresultaten naar Azure Pipelines moeten worden gepubliceerd. Hiervoor moet xcpretty zijn ingeschakeld om JUnit-testresultaten te genereren.

titel van testRunTitle - testuitvoering
string. Facultatief. Gebruiken wanneer publishJUnitResults == true.

Als xcpretty en publishJUnitResults zijn ingeschakeld, kunt u de titel van de testuitvoering opgeven.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een Xcode-werkruimte in macOS te bouwen, te testen of te archiveren en eventueel een app te verpakken.

Meerdere inrichtingsprofielen gebruiken

Er is momenteel geen ondersteuning voor meerdere inrichtingsprofielen voor de Xcode-taak (bijvoorbeeld voor de iOS-app-extensie).

Voorbeelden

Uw Xcode-app bouwen

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: xcode
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Bouwen