XamariniOS@2 - Tâche Xamarin.iOS v2

Article
07/02/2024

Utilisez cette tâche dans un pipeline pour créer une application iOS avec Xamarin sur macOS. Pour plus d’informations, consultez les instructions de Xamarin et Sign your app during CI.

Syntaxe

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

Entrées

solutionFile - Solution
Alias d’entrée : solution. string. Obligatoire. Valeur par défaut : **/*.sln.

Spécifie le chemin d’accès relatif de la racine du dépôt de la Xamarin.iOS solution ou du projet csproj à la build. Peut contenir des caractères génériques.

configuration - Configuration
string. Obligatoire. Valeur par défaut : Release.

Spécifie la configuration. Les configurations standard sont Ad Hoc, AppStore, Debug et Release.

clean - Propre
boolean. Valeur par défaut : false.

Optionnel. Exécute une build propre (/t:clean) avant la build.

packageApp - Créer un package d’application
boolean. Valeur par défaut : true.

Si la valeur trueest définie sur , génère un IPA dans le cadre de la build.

buildForSimulator - Générer pour le simulateur iOS
Alias d’entrée : forSimulator. boolean. Valeur par défaut : false.

Optionnel. Génère pour le simulateur iOS au lieu d’appareils iOS physiques.

runNugetRestore - Exécuter la restauration NuGet
boolean. Valeur par défaut : false.

S’exécute nuget restore sur la solution iOS Xamarin pour installer tous les packages référencés avant la génération. L’outil nuget dans le chemin d’accès de l’ordinateur de l’agent de build est utilisé. Pour utiliser une autre version de NuGet ou définir des arguments supplémentaires, utilisez la tâche d’installation De NuGet.

args - Arguments
string.

Optionnel. Spécifie des arguments de ligne de commande supplémentaires utilisés pour générer.

workingDirectory - Répertoire de travail
Alias d’entrée : cwd. string.

Optionnel. Spécifie le répertoire de travail dans lequel les builds s’exécuteront. Si la valeur est vide, la racine du dépôt est utilisée.

mdtoolFile - Chemin d’accès de l’outil de génération
Alias d’entrée : buildToolLocation | mdtoolLocation. string.

Optionnel. Fournit le chemin d’accès à xbuild (l’outil de génération mono de Xamarin Studio) ou à MSBuild (l’outil de génération Visual Studio pour Mac). Si la valeur est vide, le chemin xbuild ou MSBuild par défaut est utilisé.

signingIdentity - Identité de signature
Alias d’entrée : iosSigningIdentity. string.

Optionnel. Remplace l’identité de signature qui sera utilisée pour signer la build. Si la valeur est vide, le paramètre dans le projet Xcode est utilisé. Vous devrez peut-être sélectionner signingUnlockDefaultKeychain si vous utilisez cette option.

signingProvisioningProfileID - UUID du profil d’approvisionnement
Alias d’entrée : provProfileUuid. string.

Optionnel. Spécifie l’UUID d’un remplacement de profil d’approvisionnement installé à utiliser pour cette build.

Options de contrôle des tâches

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Utilisez cette tâche dans un pipeline pour créer une application iOS avec Xamarin sur macOS. Pour plus d’informations, consultez les instructions de Xamarin et Sign your app during CI.

Nouveautés de cette version de tâche

La configuration de la signature iOS a été supprimée de la tâche. Utilisez Secure Files avec les tâches Install Apple Certificate de prise en charge et Install Apple Provisioning Profile pour configurer la signature. Options mises à jour pour mieux fonctionner avec Visual Studio for Mac.

Exemples

Créer votre application Xamarin

Spécifications

Condition requise	Description
Types de pipelines	YAML, build classique
S’exécute sur	Agent, DeploymentGroup
Demandes	Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : Xamarin.iOS
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	Toutes les versions d’agent prises en charge.
Catégorie de la tâche	Build

Partage via