XamariniOS@1 - Tâche Xamarin.iOS v1

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

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

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 la génération.

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.

buildToolOption - Outil de génération
Alias d’entrée : buildTool. string. Valeurs autorisées : xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio pour Mac)). Valeur par défaut : xbuild.

Spécifie les outils de génération que la tâche utilisera.

mdtoolFile - Chemin d’accès de l’outil de génération
Alias d’entrée : 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é.

signingOption - Remplacer à l’aide de
Alias d’entrée : signMethod. string. Valeurs autorisées : file (Contenu du fichier), id (Identificateurs). Valeur par défaut : file.

Utilisez cette entrée si la build utilise une méthode de signature ou d’approvisionnement différente de la méthode par défaut. Choisissez file d’utiliser un certificat P12 et un profil d’approvisionnement. Choisissez id de récupérer les paramètres de signature à partir du trousseau par défaut et des profils préinstallés. Laissez les champs correspondants vides si vous ne souhaitez pas remplacer les paramètres de build par défaut.

signingIdentity - Identité de signature
Alias d’entrée : iosSigningIdentity. string. facultatif. Utilisez quand signMethod = id.

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.

signingUnlockDefaultKeychain - Déverrouiller le trousseau par défaut
Alias d’entrée : unlockDefaultKeychain. boolean. facultatif. Utilisez quand signMethod = id. Valeur par défaut : false.

Résout les erreurs « L’interaction utilisateur n’est pas autorisée » en déverrouillant le trousseau par défaut.

signingDefaultKeychainPassword - Mot de passe du trousseau par défaut
Alias d’entrée : defaultKeychainPassword. string. facultatif. Utilisez quand signMethod = id.

Spécifie le mot de passe pour déverrouiller le trousseau par défaut lorsque signingUnlockDefaultKeychain est défini.

signingProvisioningProfileID - UUID du profil d’approvisionnement
Alias d’entrée : provProfileUuid. string. facultatif. Utilisez quand signMethod = id.

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

signingP12File - Fichier de certificat P12
Alias d’entrée : p12. string. facultatif. Utilisez quand signMethod = file.

Spécifie le chemin d’accès relatif à un fichier de certificat P12 au format PKCS12 contenant un certificat de signature à utiliser pour cette build.

signingP12Password - Mot de passe P12
Alias d’entrée : p12pwd. string. facultatif. Utilisez quand signMethod = file.

Spécifie le mot de passe du fichier de certificat P12. Utilisez une variable de build pour chiffrer cette valeur.

signingProvisioningProfileFile - Configuration du fichier de profil
Alias d’entrée : provProfile. string. facultatif. Utilisez quand signMethod = file.

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

signingRemoveProfile - Supprimer le profil après la génération
Alias d’entrée : removeProfile. boolean. Optionnel. Utilisez quand signMethod = file. Valeur par défaut : false.

Spécifie que le contenu du fichier de profil d’approvisionnement doit être supprimé de l’agent de build une fois la génération terminée. Activez cette option uniquement si vous exécutez un agent par utilisateur.

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.

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