Xcode@4 - Attività Xcode v4

Articolo
07/02/2024

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 v4
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@4
  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' | '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. 
    #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. 
    #outputPattern: # string. Output directory. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish test results to VSTS/TFS. Default: false.

Input

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

Specifica un elenco delimitato da spazi di azioni. Le opzioni valide sono build, , cleantest, 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 la configurazione del progetto Xcode o 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 durante la compilazione del progetto Xcode o dell'area di lavoro. Dall'applicazione terminale macOS eseguire xcodebuild -showsdks per visualizzare l'elenco valido degli 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. Se si specifica un valore, è necessario specificare anche lo schema. Non specificare un valore se si specifica -target flag in Argomenti avanzati. Ad esempio, MyApp/MyApp.xcworkspace o MyApp/MyApp.xcodeproj.

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 dispone di un singolo schema condiviso, verrà usato lo schema dell'area di lavoro.

xcodeVersion - Versione Xcode
string. Valori consentiti: 8 (Xcode 8), (Xcode 9), 9default, 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 agente , ad esempio XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer. Selezionare per specificare Specify path 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 di sviluppo 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 il pacchetto dell'app
boolean. Valore predefinito: false.

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

archivePath - Percorso di archiviazione
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 per il 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 il valore predefinito di Automatic è selezionato, il metodo di esportazione viene rilevato automaticamente dall'archivio. Selezionare Plist per specificare un file plist contenente le opzioni di esportazione. Selezionare per specificare un metodo di esportazioneSpecify specifico e l'ID team.

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 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 opzioni da usare durante l'esportazione.

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

Specifica altri argomenti della riga di comando usati durante l'esportazione.

signingOption - Stile di firma
string. Valori consentiti: nosign (Non firma di codice), (Impostazione predefinita progetto), (Firma manuale), defaultmanualauto (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 diversi 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 e watchOS), tvOS, , macOScustom. iOS 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 nell'elenco. Se Default questa opzione è selezionata, non vengono assegnati simulatori o dispositivi.

destinationPlatform - Piattaforma di destinazione personalizzata
string. Facoltativa. 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.

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 utilizzato 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. Valore predefinito: iPhone 7.

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. Altre informazioni sui simulatori installati nell'agente di anteprima 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.

args - Argomenti
string.

Facoltativa. 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 : Building from the command line with Xcode FAQ (Apple: Building from the command line with Xcode FAQ).

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.

outputPattern - Directory di output
string.

Facoltativa. Specifica un percorso relativo alla directory di lavoro in cui vengono inseriti l'output di compilazione (file binari). Ad esempio, output/$(SDK)/$(Configuration) o output/$(TestSDK)/$(TestConfiguration). I percorsi di archiviazione ed esportazione vengono configurati separatamente. Specificare i valori nella scheda Variabili.

useXcpretty - Usare xcpretty
boolean. Valore predefinito: false.

Specifica se utilizzare per formattare xcodebuild l'output xcpretty e generare i risultati del test JUnit. xcpretty deve essere installato nel computer dell'agente (è preinstallato negli agenti di compilazione ospitati in VSTS). Per altre informazioni, vedere xcpretty .

publishJUnitResults - Pubblicare i risultati dei test in VSTS/TFS
boolean. Valore predefinito: false.

Se xcpretty è abilitato, questo input specifica se pubblicare i risultati del test JUnit in VSTS/TFS.

Opzioni di controllo attività

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

Variabili di output

No.

Osservazioni

Usare questa attività per compilare un'area di lavoro Xcode in macOS.

Esempio

Compilare, testare e distribuire 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à	Compilare

Condividi tramite