Xcode@5 - Attività Xcode v5

Usare questa attività per compilare, testare o archiviare un'area di lavoro Xcode in macOS e, facoltativamente, creare un pacchetto di un'app.

Sintassi

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

Input

actions - Azioni
string. Obbligatorio. Valore predefinito: build.

Specifica un elenco delimitato da spazi di azioni. Alcune opzioni valide sono build, clean, test, analyzee archive. Ad esempio,clean build esegue una compilazione pulita. Vedere Apple: Compilazione dalla riga di comando con domande frequenti su Xcode.

configuration - Configurazione
string. Valore predefinito: $(Configuration).

Specifica il progetto Xcode o la configurazione dell'area di lavoro da compilare. Quando si usa una variabile, specificare un valore , ad esempio , Releasenella scheda Variabili .

sdk - SDK
string. Valore predefinito: $(SDK).

Specifica un SDK da usare per la compilazione del progetto O dell'area di lavoro Xcode. Dall'applicazione terminale macOS eseguire xcodebuild -showsdks per visualizzare l'elenco valido di SDK. Quando si usa una variabile, specificare un valore , ad esempio , iphonesimulatornella scheda Variabili .

xcWorkspacePath - Percorso dell'area di lavoro o del progetto
string. Valore predefinito: **/*.xcodeproj/project.xcworkspace.

Facoltativa. Specifica un percorso relativo dalla radice del repository all'area di lavoro o al progetto Xcode. Ad esempio, MyApp/MyApp.xcworkspace o MyApp/MyApp.xcodeproj. È possibile usare caratteri jolly. Altre informazioni sui modelli di corrispondenza dei file.

scheme - Schema
string.

Facoltativa. Specifica un nome di schema Xcode. Deve essere uno schema condiviso (casella di controllo condivisa in Schemi gestiti in Xcode). Se non si specifica uno schema e l'area di lavoro specificata ha un singolo schema condiviso, verrà usato lo schema dell'area di lavoro.

xcodeVersion - Versione Xcode
string. Valori consentiti: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), (Xcode 11), 1112 (Xcode 12), 13 (Xcode 13), default, specifyPath (Specifica percorso). Valore predefinito: default.

Specifica la versione di destinazione di Xcode. Selezionare questa opzione Default per usare la versione predefinita di Xcode nel computer dell'agente. Se si specifica un numero di versione ( ad esempio , Xcode 9) si basa sulla posizione della versione da impostare in base alle variabili di ambiente nel computer dell'agente ( ad esempio , XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Selezionare questa opzione Specify path per specificare un percorso specifico per la directory per sviluppatori Xcode.

xcodeDeveloperDir - Percorso sviluppatore Xcode
string. Facoltativa. Usare quando xcodeVersion == specifyPath.

Specifica un percorso di una directory per sviluppatori Xcode specifica , ad esempio /Applications/Xcode_9.0.0.app/Contents/Developer. Questo input è utile quando nel computer dell'agente vengono installate più versioni di Xcode.

packageApp - Creare un pacchetto dell'app
boolean. Valore predefinito: false.

Specifica se un file di pacchetto dell'app IPA viene generato come parte della compilazione.

archivePath - Percorso archivio
string. Facoltativa. Usare quando packageApp == true.

Specifica una directory in cui vengono inseriti gli archivi creati.

exportPath - Percorso di esportazione
string. Facoltativa. Usare quando packageApp == true. Valore predefinito: output/$(SDK)/$(Configuration).

Specifica la destinazione del prodotto esportato dall'archivio.

exportOptions - Opzioni di esportazione
string. Facoltativa. Usare quando packageApp == true. Valori consentiti: auto (Automatico), plist, specify. Valore predefinito: auto.

Specifica le opzioni per l'esportazione dell'archivio. Quando viene selezionato il valore predefinito di Automatic , il metodo di esportazione viene rilevato automaticamente dall'archivio. Selezionare questa opzione Plist per specificare un file plist contenente le opzioni di esportazione. Selezionare questa opzione Specify per specificare un metodo di esportazione e un ID team specifici.

exportMethod - Metodo export
string. Obbligatorio quando exportOptions == specify. Valore predefinito: development.

Specifica il metodo usato da Xcode per esportare l'archivio. Esempio: app-store, package, ad-hoc, enterprise o development.

exportTeamId - Team ID
string. Facoltativa. Usare quando exportOptions == specify.

Specifica l'ID del team di 10 caratteri del portale per sviluppatori Apple da usare durante l'esportazione.

exportOptionsPlist - Opzioni di esportazione plist
string. Obbligatorio quando exportOptions == plist.

Specifica il percorso del file plist che contiene le opzioni da utilizzare durante l'esportazione.

exportArgs - Esportare gli argomenti
string. Facoltativa. Usare quando packageApp == true.

Specifica argomenti aggiuntivi della riga di comando utilizzati durante l'esportazione.

signingOption - Stile di firma
string. Valori consentiti: nosign (Non firma codice), default (impostazioni predefinite di Project), manual (firma manuale), auto (firma automatica). Valore predefinito: nosign.

Specifica il metodo di firma della compilazione. Selezionare per disabilitare Do not code sign la firma. Selezionare Project defaults per usare solo la configurazione di firma del progetto. Selezionare Manual signing per forzare la firma manuale e specificare facoltativamente un profilo di firma e provisioning. Selezionare Automatic signing per forzare la firma automatica e specificare facoltativamente un ID del team di sviluppo. Se il progetto richiede la firma, usare le attività Installa Apple... per installare i certificati e i profili di provisioning prima della compilazione Xcode.

signingIdentity - Identità di firma
string. Facoltativa. Usare quando signingOption = manual.

Specifica un override dell'identità di firma con cui firmare la compilazione. È possibile che sia necessario sbloccare la keychain predefinita nel computer agente. Se non viene immesso alcun valore, viene usata l'impostazione del progetto Xcode.

provisioningProfileUuid - UUID del profilo di provisioning
string. Facoltativa. Usare quando signingOption = manual.

Specifica l'UUID di un profilo di provisioning installato usato per la compilazione. Usare attività di compilazione separate con schemi o destinazioni diverse per specificare i profili di provisioning per destinazione in una singola area di lavoro (iOS, tvOS, watchOS).

provisioningProfileName - Nome del profilo di provisioning
string. Facoltativa. Usare quando signingOption = manual.

Specifica il nome di un profilo di provisioning installato usato per la compilazione. Se specificato, questo ha la precedenza sull'UUID del profilo di provisioning. Usare attività di compilazione separate con schemi o destinazioni diverse per specificare i profili di provisioning per destinazione in una singola area di lavoro (iOS, tvOS, watchOS).

teamId - Team ID
string. Facoltativa. Usare quando signingOption = auto.

Obbligatorio se si è membri di più team di sviluppo. Specifica l'ID del team di sviluppo di 10 caratteri.

destinationPlatformOption - Piattaforma di destinazione
string. Valori consentiti: default, iOS (iOS e watchOS), tvOS, macOS, custom. Valore predefinito: default.

Specifica la piattaforma del dispositivo di destinazione usata per il test dell'interfaccia utente quando il dispositivo di compilazione generico non è valido. Scegliere di Custom specificare una piattaforma non inclusa in questo elenco. Quando Default viene selezionata, non sono destinati simulatori o dispositivi.

destinationPlatform - Piattaforma di destinazione personalizzata
string. Facoltativa. Usare quando destinationPlatformOption == custom.

Specifica la piattaforma di un dispositivo di destinazione usata per il test dell'interfaccia utente quando il dispositivo di compilazione generico non è valido. Scegliere di Custom specificare una piattaforma non inclusa nell'elenco. Quando Default viene selezionata, non sono destinati simulatori né dispositivi.

destinationTypeOption - Tipo di destinazione
string. Facoltativa. Usare quando destinationPlatformOption != default && destinationPlatformOption != macOS. Valori consentiti: simulators (simulatore), devices (dispositivo connesso). Valore predefinito: simulators.

Specifica il tipo di destinazione da usare per il test dell'interfaccia utente. I dispositivi devono essere connessi al Mac che esegue la compilazione tramite un cavo o una connessione di rete. Per altre informazioni, vedere Dispositivi e simulatori in Xcode.

destinationSimulators - Simulatore
string. Facoltativa. Usare quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Specifica un nome del simulatore Xcode usato per il test dell'interfaccia utente. Ad esempio, iPhone X (iOS e watchOS) o Apple TV 4K (tvOS). È possibile specificare una versione facoltativa del sistema operativo di destinazione nel formato OS=<versionNumber>, ad esempio iPhone X,OS=11.1. Per altre informazioni, vedere questo elenco di simulatori installati nell'agente macOS ospitato.

destinationDevices - Dispositivo
string. Facoltativa. Usare quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Specifica il nome del dispositivo usato per il test dell'interfaccia utente, ad esempio Raisa's iPad. Attualmente è supportato un solo dispositivo. Si noti che Apple non consente apostrofi (') nei nomi dei dispositivi. È invece possibile usare virgolette' singole () a destra.

args - Argomenti
string.

Facoltativa. Specifica altri argomenti della riga di comando con cui compilare. Questo input è utile per specificare -target o -project argomenti anziché un'area di lavoro/progetto e uno schema. Vedere Apple: Compilazione dalla riga di comando con domande frequenti su Xcode.

workingDirectory - Directory di lavoro
Alias di input: cwd. string.

Facoltativa. Specifica la directory di lavoro in cui eseguire la compilazione. Se non viene immesso alcun valore, viene usata la radice del repository.

useXcpretty - Usare xcpretty
boolean. Valore predefinito: true.

Specifica se usare per formattare xcodebuild l'outputxcpretty. xcpretty deve essere installato nel computer agente (è preinstallato negli agenti di compilazione ospitati in Azure Pipelines). Se xcpretty non è installato, viene visualizzato l'output non elaborato xcodebuild . Per altre informazioni, vedere xcpretty .

xcprettyArgs - Argomenti Xcpretty
string. Facoltativa. Usare quando useXcpretty == true.

Se xcpretty è abilitato, questo input specifica gli argomenti per xcpretty. Vedere un elenco di argomenti xcpretty in GitHub.

publishJUnitResults - Pubblicare i risultati dei test in Azure Pipelines
boolean. Valore predefinito: false.

Specifica se pubblicare i risultati dei test JUnit in Azure Pipelines. Ciò richiede xcpretty l'abilitazione per generare i risultati dei test JUnit.

testRunTitle - Titolo esecuzione test
string. Facoltativa. Usare quando publishJUnitResults == true.

Se xcpretty e publishJUnitResults sono abilitati, è possibile specificare il titolo dell'esecuzione del test.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività per compilare, testare o archiviare un'area di lavoro Xcode in macOS e, facoltativamente, creare un pacchetto di un'app.

Uso di più profili di provisioning

Attualmente non è disponibile alcun supporto di più profili di provisioning per l'attività Xcode , ad esempio per l'estensione dell'app iOS.

Esempio

Compilare l'app Xcode

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che soddisfano le richieste seguenti per eseguire processi che usano questa attività: xcode
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Compilazione