XamariniOS@2 - Attività Xamarin.iOS v2

Articolo
03/24/2025

XamariniOS@2 è deprecato. In origine, questa attività è stata usata come pipeline per compilare un'app iOS con Xamarin in macOS. Per altre informazioni, vedere le linee guida Xamarin e Firmare l'app durante l'integrazione continua.

Nota

Questa attività è deprecata ed è stata ritirata il 1° maggio 2024.

Nota

Questa attività è deprecata ed è stata ritirata il 1° maggio 2024.

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.

Ingressi dati

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

Specifica il percorso relativo dalla radice del repository del progetto di Xamarin.iOS soluzione o 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 - clean
boolean. Valore predefinito: false

Opzionale. 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 IPA come parte della compilazione.

buildForSimulator - Build for iOS Simulator
Alias di input: forSimulator. boolean. Valore predefinito: false

Opzionale. Compilazioni per il simulatore iOS anziché per i dispositivi iOS fisici.

runNugetRestore - Eseguire il ripristino nuGet
boolean. Valore predefinito: false

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

args - argomenti
string.

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

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

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

Opzionale. Specifica il percorso di xbuild (lo strumento di compilazione mono di Xamarin Studio) o MSBuild (lo strumento di compilazione di 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.

Opzionale. 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 - profilo di provisioning UUID
Alias di input: provProfileUuid. string.

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

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.

Osservazioni:

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

Novità di questa versione dell'attività

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

Esempi

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 corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: Xamarin.iOS
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

Condividi tramite