Condividi tramite

Xcode@2 - Attività Xcode Build v2

  • Articolo

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

Sintassi

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

Input

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

Specifica un elenco delimitato da spazi di azioni. Le opzioni valide sono build, clean, analyzetest, e archive. Ad esempio, build clean esegue una compilazione pulita. Vedere Apple : Building from the command line with Xcode FAQ (Apple: Building from the command line with Xcode FAQ).


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

Compila un progetto O un'area di lavoro Xcode sull'SDK specificato. Eseguire xcodebuild -showsdks per visualizzare un elenco valido di SDK.


xcWorkspacePath - Area di lavoro/Percorso progetto
string. Valore predefinito: **/*.xcodeproj/*.xcworkspace.

facoltativo. Specifica il percorso relativo dalla radice del repository all'area di lavoro o al progetto Xcode. Ad esempio, MyApp/MyApp.xcworkspace o MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Lasciare vuoto se si intende usare -target flag in Argomenti avanzati.


scheme - Schema
string.

facoltativo. Specifica il nome dello schema Xcode. Deve essere uno schema condiviso (casella di controllo condivisa in Schemi gestiti in Xcode). Obbligatorio se l'area di lavoro è specificata.


packageApp - Creare il pacchetto dell'app
boolean. Valore predefinito: true.

Specifica se un IPA viene generato come parte della compilazione. Per l'esportazione di archivi con Xcode 7 e Xcode 8, vedere input aggiuntivi nella sezione Opzioni pacchetto .


packageTool - Creare un pacchetto (IPA) usando
string. Obbligatorio. Valori consentiti: xcrun (xcrun (deprecato da Apple)), xcodebuild (archivio xcodebuild ed esportazione). Valore predefinito: xcodebuild.

Specifica lo strumento da usare per generare l'IPA.


archivePath - Percorso archivio
string. facoltativo. Usare quando packageTool == xcodebuild.

Specifica una directory in cui vengono inseriti gli archivi creati.


exportPath - Percorso di esportazione
string. facoltativo. Usare quando packageTool == xcodebuild. Valore predefinito: output/$(SDK)/$(Configuration).

Specifica la destinazione del prodotto esportato dall'archivio.


exportOptions - Opzioni di esportazione
string. facoltativo. Usare quando packageTool == xcodebuild. Valori consentiti: auto, plist, specify. Valore predefinito: auto.

Specifica un modo per passare le opzioni di esportazione durante l'esportazione dell'archivio.


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

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


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

Specifica l'ID team del portale per sviluppatori Apple a 10 cifre da usare per l'esportazione.


exportOptionsPlist - Esporta opzioni Plist
string. Obbligatorio quando exportOptions == plist.

Specifica il percorso di un file plist che configura l'esportazione dell'archivio.


xcode8AutomaticSigning - Firma automatica
boolean. Valore predefinito: false.

Usare questo input se si dispone di un progetto Xcode 8 o Xcode 9 configurato per la firma automatica.


teamId - Team ID
string. facoltativo. Usare quando xcode8AutomaticSigning = true.

Specifica l'ID del team di sviluppo a 10 cifre. Questa operazione è necessaria se si è membri di più team di sviluppo.


signMethod - Eseguire l'override tramite
string. Valori consentiti: file (Contenuto file), id (Identificatori). Valore predefinito: file.

Usare questo input se la compilazione usa un metodo di firma o di provisioning diverso da quello predefinito. Scegliere File Contents di usare un certificato P12 e un profilo di provisioning. Scegliere Identifiers di recuperare le impostazioni di firma dal portachiavi predefinito e dai profili preinstallati. Lasciare vuoti i campi corrispondenti se non si desidera eseguire l'override delle impostazioni di compilazione predefinite.


iosSigningIdentity - Identità di firma
string. facoltativo. Usare quando signMethod = id.

Specifica l'override dell'identità di firma utilizzata per firmare la compilazione. Il valore predefinito è l'impostazione del progetto Xcode. Sblocca portachiavi predefinita potrebbe essere necessario selezionare.


unlockDefaultKeychain - Sblocca portachiavi predefinita
boolean. facoltativo. Usare quando signMethod = id. Valore predefinito: false.

Risolve gli errori di interazione utente non consentiti sbloccando il keychain predefinito.


defaultKeychainPassword - Password portachiavi predefinita
string. facoltativo. Usare quando signMethod = id.

Specifica la password per sbloccare il portachiavi predefinito.


provProfileUuid - UUID profilo di provisioning
string. facoltativo. Usare quando signMethod = id.

Specifica l'UUID di un profilo di provisioning installato da usare 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, WatchKit, tvOS).


p12 - File di certificato P12
string. facoltativo. Usare quando signMethod = file.

Specifica il percorso relativo di un file di certificato P12 formattato PKCS12 che contiene un certificato di firma da utilizzare per la compilazione.


p12pwd - P12 Password
string. facoltativo. Usare quando signMethod = file.

Specifica la password di un file di certificato P12, se specificato. Usare una variabile di compilazione per crittografare.


provProfile - File del profilo di provisioning
string. facoltativo. Usare quando signMethod = file.

Specifica il percorso relativo di un file contenente un override del profilo di provisioning da utilizzare 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, WatchKit, tvOS).


removeProfile - Rimuovi profilo dopo la compilazione
boolean. facoltativo. Usare quando signMethod = file. Valore predefinito: false.

Rimuove il contenuto del file del profilo di provisioning dall'agente di compilazione al termine della compilazione. Controllare solo se si esegue un agente per utente.


args - Argomenti
string.

Specifica argomenti aggiuntivi della riga di comando utilizzati per la compilazione. Questo input è utile se si vuole usare -target o -project invece di specificare un'area di lavoro e uno schema.


cwd - Directory di lavoro
string.

Specifica la directory di lavoro per le esecuzioni di compilazione. Il valore predefinito è la radice del repository.


outputPattern - Output Directory
string. Obbligatorio. Valore predefinito: output/$(SDK)/$(Configuration).

Specifica il percorso relativo in cui vengono inseriti gli output di compilazione (file binari).


xcodeDeveloperDir - Percorso sviluppatore Xcode
string.

facoltativo. Specifica il percorso della cartella Xcode Developer se non è l'impostazione predefinita del sistema. Per l'uso quando vengono installate più versioni di Xcode in un sistema. Ad esempio: /Applications/Xcode 7.app/Contents/Developer.


useXcpretty - Usare xcpretty
boolean. Valore predefinito: false.

Formatta xcodebuild l'output e genera un report dei risultati del test JUnit. Deve essere installato negli host dell'agente. Altre informazioni su xcpretty.


publishJUnitResults - Pubblicare in VSTS/TFS
boolean. Valore predefinito: false.

I risultati dei test JUnit prodotti tramite xctool vengono pubblicati in VSTS/TFS.


useXctool - Usare xctool
boolean.

Usa xctool invece di xcodebuild. Deve essere installato negli host dell'agente. Altre informazioni su xctool.
Nota:xctool è deprecato e non funziona con Xcode 8.


xctoolReporter - Formato reporter test xctool
string.

Verifica il formato del reporter da usare quando viene specificata l'azione di test e viene selezionato Usa xctool . Specificare junit:output-file-path-here.xml per generare un formato di file compatibile con l'attività Pubblica risultati test. Se specificato, viene aggiunto automaticamente plain. xctool deve essere installato negli host dell'agente. Altre informazioni su xctool.
Nota:xctool è deprecato e non funziona con Xcode 8.


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.

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