Condividi tramite

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.

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

# 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' | '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: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
    #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.
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.

Ingressi dati

actions - Azioni
string. Obbligatorio. Valore predefinito: build

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


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

Specifica la configurazione del progetto Xcode o dell'area di lavoro da compilare. Quando si usa una variabile, specificare un valore (ad esempio, Release) nella scheda Variabili.


sdk - Sdraietta
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 degli SDK. Quando si usa una variabile, specificare un valore (ad esempio, iphonesimulator) nella scheda Variabili.


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

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

Opzionale. 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), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Specifica percorso). Valore predefinito: default

Specifica la versione di destinazione di Xcode. Selezionare Default per usare la versione predefinita di Xcode nel computer 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 Specify path per fornire un percorso specifico alla directory per sviluppatori Xcode.


xcodeVersion - versione Xcode
string. Valori consentiti: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), default, specifyPath (Specificare il percorso). Valore predefinito: default

Specifica la versione di destinazione di Xcode. Selezionare Default per usare la versione predefinita di Xcode nel computer 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 Specify path per fornire un percorso specifico alla directory per sviluppatori Xcode.


xcodeDeveloperDir - percorso di sviluppo Xcode
string. Opzionale. 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 agente vengono installate più versioni di Xcode.


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

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


archivePath - percorso di archiviazione
string. Opzionale. Usare quando packageApp == true.

Specifica una directory in cui vengono inseriti gli archivi creati.


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

Specifica la destinazione del prodotto esportato dall'archivio.


exportOptions - Opzioni di esportazione
string. Opzionale. 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 Plist per specificare un file plist contenente le opzioni di esportazione. Selezionare Specify per specificare un metodo Export specifico e ID team.


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

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


exportTeamId - ID team
string. Opzionale. Usare quando exportOptions == specify.

Specifica l'ID del team di 10 caratteri di Apple Developer Portal 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 argomenti
string. Opzionale. Usare quando packageApp == true.

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


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

Specifica il metodo di firma della compilazione. Selezionare Do not code sign per disabilitare la firma. Selezionare Project defaults per usare solo la configurazione di firma del progetto. Selezionare Manual signing per forzare la firma manuale e, facoltativamente, specificare un'identità di firma e un profilo di provisioning. Selezionare Automatic signing per forzare la firma automatica e, facoltativamente, specificare 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. Opzionale. Usare quando signingOption = manual.

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


provisioningProfileUuid - profilo di provisioning UUID
string. Opzionale. 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 diversi per specificare i profili di provisioning per destinazione in una singola area di lavoro (iOS, tvOS, watchOS).


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

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


teamId - ID team
string. Opzionale. Usare quando signingOption = auto.

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


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

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


destinationPlatform - della piattaforma di destinazione personalizzata
string. Opzionale. Usare quando destinationPlatformOption == custom.

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


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

Specifica il tipo di destinazione da utilizzare 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.


simulatore di destinationSimulators -
string. Opzionale. Usare quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Specifica un nome di 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.


simulatore di destinationSimulators -
string. Opzionale. Usare quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Valore predefinito: iPhone 7

Specifica un nome di 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 - del dispositivo
string. Opzionale. 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. Al momento è supportato un solo dispositivo. Si noti che Apple non consente l'uso di apostrofi (') nei nomi dei dispositivi. Al contrario, è possibile utilizzare le virgolette' singole () corrette.


args - argomenti
string.

Opzionale. Specifica argomenti della riga di comando aggiuntivi con cui compilare. Questo input è utile per specificare -target o -project argomenti anziché un'area di lavoro/progetto e uno schema. Vedere Apple: Domande frequenti sulla compilazione dalla riga di comando con Xcode.


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

Opzionale. 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 utilizzare xcpretty per formattare xcodebuild l'output. xcpretty deve essere installato nel computer dell'agente (è preinstallato negli agenti di compilazione ospitati di Azure Pipelines). Se xcpretty non è installato, viene visualizzato l'output non elaborato xcodebuild . Per altre informazioni, vedere xcpretty.


xcprettyArgs - Argomenti di Xcpretty
string. Opzionale. Usare quando useXcpretty == true.

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


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

Specifica se pubblicare i risultati del test JUnit in Azure Pipelines. Ciò richiede xcpretty di essere abilitati per generare i risultati del test JUnit.


testRunTitle - Titolo esecuzione test
string. Opzionale. 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 uscita

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.

Utilizzo di più profili di provisioning

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

Esempi

Crea la tua 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 corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: xcode
Funzionalità Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione agente Tutte le versioni dell'agente supportate.
Categoria attività Costruire