XamariniOS@1 - Attività Xamarin.iOS v1

Usare questa attività in una pipeline per compilare un'app iOS con Xamarin in macOS. Per altre informazioni, vedere le linee guida per Xamarin e Firmare l'app durante l'integrazione continua.

Sintassi

# Xamarin.iOS v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

Input

solutionFile - Soluzione
Alias di input: solution. string. Obbligatorio. Valore predefinito: **/*.sln.

Specifica il percorso relativo dalla radice del repository della Xamarin.iOS soluzione alla compilazione. Può contenere caratteri jolly.

configuration - Configurazione
string. Obbligatorio. Valore predefinito: Release.

Specifica la configurazione. Le configurazioni standard sono ad hoc, AppStore, Debug e Release.

clean - Pulito
boolean. Valore predefinito: false.

Facoltativa. Esegue una compilazione pulita (/t:clean) prima della compilazione.

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

Se impostato su true, genera un'interfaccia IPA come parte della compilazione.

buildForSimulator - Compilazione per il simulatore iOS
Alias di input: forSimulator. boolean. Valore predefinito: false.

Facoltativa. Compila per il simulatore iOS invece dei dispositivi iOS fisici.

runNugetRestore - Eseguire il ripristino NuGet
boolean. Valore predefinito: true.

Viene eseguito nuget restore nella soluzione Xamarin iOS per installare tutti i pacchetti a cui si fa riferimento prima della compilazione. Viene nuget usato lo strumento nel percorso del computer dell'agente di compilazione. Per usare una versione diversa di NuGet o impostare argomenti aggiuntivi, usare l'attività Programma di installazione NuGet.

args - Argomenti
string.

Facoltativa. Specifica argomenti della riga di comando aggiuntivi utilizzati per la compilazione.

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

Facoltativa. Specifica la directory di lavoro in cui verranno eseguite le compilazioni. Se il valore è vuoto, viene usata la radice del repository.

buildToolOption - Strumento di compilazione
Alias di input: buildTool. string. Valori consentiti: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio per Mac)). Valore predefinito: xbuild.

Specifica gli strumenti di compilazione che verranno usati dall'attività.

mdtoolFile - Percorso dello strumento di compilazione
Alias di input: mdtoolLocation. string.

Facoltativa. Fornisce il percorso di xbuild (lo strumento di compilazione mono di Xamarin Studio) o MSBuild (lo strumento di compilazione Visual Studio per Mac). Se il valore è vuoto, viene usato il percorso xbuild o MSBuild predefinito.

signingOption - Eseguire l'override con
Alias di input: signMethod. 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 di usare un certificato P12 e un profilo di provisioning. Scegliere id di recuperare le impostazioni di firma dal keychain predefinito e dai profili preinstallati. Lasciare vuoti i campi corrispondenti se non si desidera eseguire l'override delle impostazioni di compilazione predefinite.

signingIdentity - Identità di firma
Alias di input: iosSigningIdentity. string. Facoltativa. Usare quando signMethod = id.

Esegue l'override dell'identità di firma che verrà usata per firmare la compilazione. Se il valore è vuoto, verrà usata l'impostazione nel progetto Xcode. Potrebbe essere necessario selezionare signingUnlockDefaultKeychain se si usa questa opzione.

signingUnlockDefaultKeychain - Sbloccare il portachiavi predefinito
Alias di input: unlockDefaultKeychain. boolean. Facoltativa. Usare quando signMethod = id. Valore predefinito: false.

Risolve gli errori "L'interazione dell'utente non è consentita" sbloccando il keychain predefinito.

signingDefaultKeychainPassword - Password portachiavi predefinita
Alias di input: defaultKeychainPassword. string. Facoltativa. Usare quando signMethod = id.

Specifica la password per sbloccare il keychain predefinito quando signingUnlockDefaultKeychain è impostato.

signingProvisioningProfileID - UUID del profilo di provisioning
Alias di input: provProfileUuid. string. Facoltativa. Usare quando signMethod = id.

Specifica l'UUID di un profilo di provisioning installato da usare per questa compilazione.

signingP12File - File di certificato P12
Alias di input: p12. string. Facoltativa. Usare quando signMethod = file.

Specifica il percorso relativo di un file di certificato P12 in formato PKCS12 contenente un certificato di firma da usare per questa compilazione.

signingP12Password - Password P12
Alias di input: p12pwd. string. Facoltativa. Usare quando signMethod = file.

Specifica la password per il file di certificato P12. Usare una variabile di compilazione per crittografare questo valore.

signingProvisioningProfileFile - File del profilo di provisioning
Alias di input: provProfile. string. Facoltativa. Usare quando signMethod = file.

Specifica l'UUID di un override del profilo di provisioning installato da usare per questa compilazione.

signingRemoveProfile - Rimuovere il profilo dopo la compilazione
Alias di input: removeProfile. boolean. Facoltativa. Usare quando signMethod = file. Valore predefinito: false.

Specifica che il contenuto del file del profilo di provisioning deve essere rimosso dall'agente di compilazione dopo il completamento della compilazione. Abilitare questa opzione solo se si esegue un agente per utente.

Opzioni di controllo 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
Esecuzione in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: Xamarin.iOS
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