Xcode@5 - Xcode v5-taak

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

Syntax

# 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.

Invoerwaarden

actions - Acties
string. Vereist. Standaardwaarde: build.

Hiermee geeft u een door spaties gescheiden lijst met acties op. Enkele geldige opties zijn build, clean, test, analyzeen archive. Voert bijvoorbeeldclean build 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 geeft u een SDK op die moet worden gebruikt bij het bouwen van het Xcode-project of de werkruimte. Voer in de macOS Terminal-toepassing uit xcodebuild -showsdks 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.

Optioneel. Hiermee geeft u een relatief pad op van de hoofdmap van de opslagplaats naar de Xcode-werkruimte of het Xcode-project. Bijvoorbeeld MyApp/MyApp.xcworkspace of MyApp/MyApp.xcodeproj. Jokertekens kunnen worden gebruikt. Meer informatie over patronen voor het vergelijken van bestanden.

scheme - Regeling
string.

Optioneel. Hiermee geeft u een Xcode-schemanaam op. 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. Optioneel. Gebruik 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 zijn geïnstalleerd op de agentcomputer.

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. Optioneel. Gebruik wanneer packageApp == true.

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

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

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

exportOptions - Exportopties
string. Optioneel. Gebruik 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 in het archief. Selecteer Plist om een plist-bestand met exportopties op te geven. Selecteer Specify om een specifieke exportmethode en team-id op te geven.

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

Hiermee geeft u de methode op die Xcode gebruikt om het archief te exporteren. Bijvoorbeeld: app-store, package, ad-hoc, enterprise, of development.

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

Hiermee geeft u de team-id van 10 tekens van de Apple Developer Portal op die tijdens het exporteren moet worden gebruikt.

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

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

exportArgs - Argumenten exporteren
string. Optioneel. Gebruik wanneer packageApp == true.

Hiermee geeft u aanvullende opdrachtregelargumenten die worden gebruikt tijdens het exporteren.

signingOption - Ondertekeningsstijl
string. Toegestane waarden: nosign (Geen code ondertekenen), default (standaardinstellingen voor 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 deze optie om handmatige ondertekening af te dwingen en eventueel een ondertekenings-id en inrichtingsprofiel op te geven. Selecteer Automatic signing deze optie om automatische ondertekening af te dwingen en geef eventueel een id van het ontwikkelteam op. Als uw project moet worden ondertekend, gebruikt u de taken Apple installeren... om certificaten en inrichtingsprofielen vóór de Xcode-build te installeren.

signingIdentity - Ondertekeningsidentiteit
string. Optioneel. Gebruik wanneer signingOption = manual.

Hiermee geeft u een ondertekeningsidentiteit op waarmee de build moet worden ondertekend. Mogelijk moet de standaardsleutelhanger op de agentcomputer worden ontgrendeld. Als er geen waarde wordt ingevoerd, wordt de instelling van het Xcode-project gebruikt.

provisioningProfileUuid - UUID van inrichtingsprofiel
string. Optioneel. Gebruik 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 per doel op te geven in één werkruimte (iOS, tvOS, watchOS).

provisioningProfileName - Naam van inrichtingsprofiel
string. Optioneel. Gebruik wanneer signingOption = manual.

Hiermee geeft u de naam 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 per doel op te geven in één werkruimte (iOS, tvOS, watchOS).

teamId - Team-id
string. Optioneel. Gebruik wanneer signingOption = auto.

Vereist als u lid bent van meerdere ontwikkelteams. Hiermee geeft u de id van het ontwikkelteam 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 build-apparaat niet geldig is. Kies Custom ervoor om een platform op te geven dat niet in deze lijst is opgenomen. Wanneer Default is geselecteerd, worden er geen simulators of apparaten gebruikt.

destinationPlatform - Aangepast doelplatform
string. Optioneel. Gebruik wanneer destinationPlatformOption == custom.

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

destinationTypeOption - Doeltype
string. Optioneel. Gebruik 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. Optioneel. Gebruik wanneer destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Hiermee geeft u de naam van een Xcode-simulator 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 - Apparaat
string. Optioneel. Gebruik 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. Houd er rekening mee dat Apple geen apostrofs (') in apparaatnamen toestaat. In plaats daarvan kunnen rechtse enkele aanhalingstekens (') worden gebruikt.

args - Argumenten
string.

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

workingDirectory - Werkmap
Invoeralias: cwd. string.

Optioneel. 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 moet worden gebruikt xcpretty om uitvoer op te maken xcodebuild . 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. Optioneel. Gebruik wanneer useXcpretty == true.

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

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

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

testRunTitle - Titel van testuitvoering
string. Optioneel. Gebruik 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 voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

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

Meerdere inrichtingsprofielen gebruiken

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

Voorbeelden

Uw Xcode-app bouwen

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	Ontwikkelen