XamariniOS@2 - Attività Xamarin.iOS v2

Articolo
07/02/2024

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 v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  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: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

Input

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

Specifica il percorso relativo dalla radice del repository della soluzione o del Xamarin.iOS progetto csproj 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: false.

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.

mdtoolFile - Percorso dello strumento di compilazione
Alias di input: buildToolLocation | 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.

signingIdentity - Identità di firma
Alias di input: iosSigningIdentity. string.

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

signingProvisioningProfileID - UUID del profilo di provisioning
Alias di input: provProfileUuid. string.

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

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

Novità di questa versione dell'attività

La configurazione di registrazione di iOS è stata rimossa dall'attività. Usare Secure Files con le attività Install Apple Certificate di supporto e Install Apple Provisioning Profile per configurare la firma. Opzioni aggiornate per migliorare il funzionamento con Visual Studio for Mac.

Esempio

Compilare l'app Xamarin

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à: 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

Condividi tramite