Xcode@4 - Attività Xcode v4

2025-06-24

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.

Ingressi dati

actions - Azioni
string. Obbligatorio. Valore predefinito: build

Specifica un elenco delimitato da spazi di azioni. Le opzioni valide sono build, clean, testanalyze, e archive. Ad esempio,clean build esegue una compilazione pulita. Vedere Apple: Building from the command line with Xcode FAQ (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, 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. 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.

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), 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.

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 di pacchetto dell'app IPA deve essere 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).

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 per specificare una piattaforma non inclusa nell'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.

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

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: Building from the command line with Xcode FAQ (Domande frequenti su 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.

outputPattern - directory di output
string.

Opzionale. Specifica un percorso relativo alla directory di lavoro in cui vengono inseriti gli 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 xcpretty per formattare xcodebuild output e generare i risultati del test JUnit. xcpretty deve essere installato nel computer 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 di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

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

Esempi

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