Xcode@5 – Xcode v5-uppgift

Använd den här uppgiften för att skapa, testa eller arkivera en Xcode-arbetsyta på macOS och om du vill kan du paketera en app.

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.

Indata

actions - Åtgärder
string. Krävs. Standardvärde: build.

Anger en utrymmesavgränsad lista över åtgärder. Några giltiga alternativ är build, clean, test, analyzeoch archive. Utför till exempelclean build en ren version. Se Apple: Skapa från kommandoraden med vanliga frågor och svar om Xcode.

configuration - Konfiguration
string. Standardvärde: $(Configuration).

Anger Xcode-projektet eller arbetsytans konfiguration som ska skapas. När du använder en variabel anger du ett värde (till exempel Release) på fliken Variabler .

sdk - SDK
string. Standardvärde: $(SDK).

Anger en SDK som ska användas när du skapar Xcode-projektet eller arbetsytan. Från macOS Terminal-programmet kör du xcodebuild -showsdks för att visa en giltig lista över SDK:er. När du använder en variabel anger du ett värde (till exempel iphonesimulator) på fliken Variabler .

xcWorkspacePath - Arbetsyta eller projektsökväg
string. Standardvärde: **/*.xcodeproj/project.xcworkspace.

Valfritt. Anger en relativ sökväg från lagringsplatsens rot till Xcode-arbetsytan eller projektet. Exempel: MyApp/MyApp.xcworkspace eller MyApp/MyApp.xcodeproj. Jokertecken kan användas. Läs mer om filmatchningsmönster.

scheme - System
string.

Valfritt. Anger ett Xcode-schemanamn. Måste vara ett delat schema (delad kryssruta under Hanterade scheman i Xcode). Om du inte anger något schema och den angivna arbetsytan har ett enda delat schema används arbetsyteschemat.

xcodeVersion - Xcode-version
string. Tillåtna värden: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Ange sökväg). Standardvärde: default.

Anger målversionen av Xcode. Välj Default att använda standardversionen av Xcode på agentdatorn. Om du anger ett versionsnummer (till exempel Xcode 9) används versionens plats för att anges av miljövariabler på agentdatorn (till exempel XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Välj Specify path för att ange en specifik sökväg till Xcode-utvecklarkatalogen.

xcodeDeveloperDir - Xcode-utvecklarsökväg
string. Valfritt. Använd när xcodeVersion == specifyPath.

Anger en sökväg till en specifik Xcode-utvecklarkatalog (till exempel /Applications/Xcode_9.0.0.app/Contents/Developer). Den här indatan är användbar när flera versioner av Xcode är installerade på agentdatorn.

packageApp - Skapa apppaket
boolean. Standardvärde: false.

Anger om en IPA-appaketfil genereras som en del av versionen.

archivePath - Arkivsökväg
string. Valfritt. Använd när packageApp == true.

Anger en katalog där skapade arkiv placeras.

exportPath - Exportera sökväg
string. Valfritt. Använd när packageApp == true. Standardvärde: output/$(SDK)/$(Configuration).

Anger målet för produkten som exporteras från arkivet.

exportOptions - Exportera alternativ
string. Valfritt. Använd när packageApp == true. Tillåtna värden: auto (automatisk), plist, specify. Standardvärde: auto.

Anger alternativ för att exportera arkivet. När standardvärdet Automatic för är valt identifieras exportmetoden automatiskt från arkivet. Välj Plist för att ange en plist-fil som innehåller exportalternativ. Välj Specify för att ange en specifik exportmetod och team-ID.

exportMethod - Exportmetod
string. Krävs när exportOptions == specify. Standardvärde: development.

Anger den metod som Xcode använder för att exportera arkivet. Till exempel: app-store, package, ad-hoc, enterpriseeller development.

exportTeamId - Team-ID
string. Valfritt. Använd när exportOptions == specify.

Anger det 10-teckens team-ID för Apple Developer Portal som ska användas under exporten.

exportOptionsPlist - Exportera alternativ plist
string. Krävs när exportOptions == plist.

Anger sökvägen till plist-filen som innehåller alternativ som ska användas under exporten.

exportArgs - Exportera argument
string. Valfritt. Använd när packageApp == true.

Anger ytterligare kommandoradsargument som används under exporten.

signingOption - Signeringsformat
string. Tillåtna värden: nosign (Koda inte tecken), default (Project defaults), manual (Manuell signering) auto (automatisk signering). Standardvärde: nosign.

Anger metoden för att signera bygget. Välj Do not code sign för att inaktivera signering. Välj Project defaults att endast använda projektets signeringskonfiguration. Välj Manual signing att framtvinga manuell signering och om du vill kan du ange en signeringsidentitet och etableringsprofil. Välj Automatic signing för att framtvinga automatisk signering och ange eventuellt ett utvecklingsteam-ID. Om projektet kräver signering använder du uppgifterna Installera Apple... för att installera certifikat och etableringsprofiler före Xcode-versionen.

signingIdentity - Signeringsidentitet
string. Valfritt. Använd när signingOption = manual.

Anger en åsidosättning av signeringsidentitet som bygget ska signeras med. Du kan behöva låsa upp standardnyckelringen på agentdatorn. Om inget värde anges används Xcode-projektets inställning.

provisioningProfileUuid - UUID för etableringsprofil
string. Valfritt. Använd när signingOption = manual.

Anger UUID för en installerad etableringsprofil som används för versionen. Använd separata bygguppgifter med olika scheman eller mål för att ange etableringsprofiler efter mål på en enda arbetsyta (iOS, tvOS, watchOS).

provisioningProfileName - Namn på etableringsprofil
string. Valfritt. Använd när signingOption = manual.

Anger namnet på en installerad etableringsprofil som används för bygget. Om detta anges har detta företräde framför etableringsprofilens UUID. Använd separata bygguppgifter med olika scheman eller mål för att ange etableringsprofiler efter mål på en enda arbetsyta (iOS, tvOS, watchOS).

teamId - Team-ID
string. Valfritt. Använd när signingOption = auto.

Krävs om du är medlem i flera utvecklingsteam. Anger utvecklingsteamets ID på 10 tecken.

destinationPlatformOption - Målplattform
string. Tillåtna värden: default, iOS (iOS och watchOS), tvOS, macOS, custom. Standardvärde: default.

Anger målenhetens plattform som används för gränssnittstestning när den allmänna byggenheten inte är giltig. Välj Custom att ange en plattform som inte ingår i den här listan. När Default har valts riktas inga simulatorer eller enheter.

destinationPlatform - Anpassad målplattform
string. Valfritt. Använd när destinationPlatformOption == custom.

Anger en målenhets plattform som används för gränssnittstestning när den allmänna byggenheten inte är giltig. Välj Custom att ange en plattform som inte ingår i listan. När Default har valts är inga simulatorer eller enheter riktade.

destinationTypeOption - Måltyp
string. Valfritt. Använd när destinationPlatformOption != default && destinationPlatformOption != macOS. Tillåtna värden: simulators (simulator), devices (ansluten enhet). Standardvärde: simulators.

Anger måltypen som ska användas för gränssnittstestning. Enheterna måste vara anslutna till mac-datorn som utför bygget via en kabel- eller nätverksanslutning. Mer information finns i Enheter och simulatorer i Xcode.

destinationSimulators - Simulator
string. Valfritt. Använd när destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Anger ett Xcode-simulatornamn som används för UI-testning. Till exempel iPhone X (iOS och watchOS) eller Apple TV 4K (tvOS). En valfri mål-OS-version kan anges i formatet OS=<versionNumber>, till exempel iPhone X,OS=11.1. Mer information finns i den här listan över simulatorer som är installerade på den värdbaserade macOS-agenten.

destinationDevices - Enhet
string. Valfritt. Använd när destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Anger namnet på enheten som används för UI-testning, till exempel Raisa's iPad. Endast en enhet stöds för närvarande. Observera att Apple inte tillåter apostrofer (') i enhetsnamn. I stället kan höger enkla citattecken (') användas.

args - Argument
string.

Valfritt. Anger ytterligare kommandoradsargument som du vill skapa med. Dessa indata är användbara för att -target ange eller -project argument i stället för en arbetsyta/ett projekt och ett schema. Se Apple: Skapa från kommandoraden med vanliga frågor och svar om Xcode.

workingDirectory - Arbetskatalog
Indataalias: cwd. string.

Valfritt. Anger arbetskatalogen där bygget ska köras. Om inget värde anges används lagringsplatsens rot.

useXcpretty - Använda xcpretty
boolean. Standardvärde: true.

Anger om utdata ska formateras xcprettyxcodebuild . xcpretty måste installeras på agentdatorn (den är förinstallerad på Azure Pipelines-värdbaserade byggagenter). Om xcpretty inte har installerats visas råutdata xcodebuild . Mer information finns i xcpretty .

xcprettyArgs - Xcpretty-argument
string. Valfritt. Använd när useXcpretty == true.

Om xcpretty är aktiverat anger dessa indata argument för xcpretty. Se en lista över xcpretty-argument på GitHub.

publishJUnitResults - Publicera testresultat till Azure Pipelines
boolean. Standardvärde: false.

Anger om JUnit-testresultat ska publiceras till Azure Pipelines. Detta kräver xcpretty att aktiveras för att generera JUnit-testresultat.

testRunTitle - Testkörningsrubrik
string. Valfritt. Använd när publishJUnitResults == true.

Om xcpretty och publishJUnitResults är aktiverade kan du ange testkörningsrubriken.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Använd den här uppgiften för att skapa, testa eller arkivera en Xcode-arbetsyta på macOS och om du vill kan du paketera en app.

Använda flera etableringsprofiler

För närvarande finns det inget stöd för flera etableringsprofiler för Xcode-aktiviteten (till exempel för iOS-apptillägget).

Exempel

Skapa din Xcode-app

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Lokalt installerade agenter måste ha funktioner som matchar följande krav för att köra jobb som använder den här uppgiften: xcode
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	Alla agentversioner som stöds.
Uppgiftskategori	Skapa