XamarinAndroid@1 - Tâche Xamarin.Android v1

Utilisez cette tâche pour créer une application Android avec Xamarin.

Syntax

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

Entrées

projectFile - Projet
Alias d’entrée : project. string. Obligatoire. Valeur par défaut : **/*.csproj.

Spécifie le chemin d’accès relatif de la racine du dépôt du ou des Xamarin.Android projets à générer. Des caractères génériques peuvent être utilisés. Pour plus d’informations, consultez la référence modèles de correspondance de fichiers. Par exemple, **/*.csproj pour tous les fichiers csproj dans tous les sous-dossiers. Le projet doit avoir une PackageForAndroid cible si Create App Package est sélectionné.

target - Cible
string.

Spécifie les cibles à générer dans ce projet. Utilisez un point-virgule pour séparer les cibles.

outputDirectory - Répertoire de sortie
Alias d’entrée : outputDir. string.

facultatif. Fournit le répertoire de sortie pour la build. Exemple : $(build.binariesDirectory)/bin/Release.

configuration - Configuration
string.

Spécifie la configuration que vous souhaitez générer. Par exemple, debug ou release.

Conseil

Déclarez une variable de build telle que BuildConfiguration sous l’onglet variables (en sélectionnant Allow au moment de la file d’attente) et référencez-la ici en tant que $(BuildConfiguration). Vous pouvez ensuite modifier la plateforme lorsque vous mettez en file d’attente la build et activez la génération de plusieurs configurations.

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

Transmet la cible, (/t:PackageForAndroid), pendant la génération pour générer un APK.

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

Transmet le propre cible, (/t:clean), pendant la génération.

msbuildLocationOption - Msbuild
Alias d’entrée : msbuildLocationMethod. string. Valeurs autorisées : version, location (Spécifier l’emplacement). Valeur par défaut : version.

Spécifie le chemin d’accès à MSBuild (sur Windows) ou xbuild (sur macOS). Le comportement par défaut consiste à rechercher la dernière version.

msbuildVersionOption - Version de MSBuild
Alias d’entrée : msbuildVersion. string. facultatif. Utilisez quand msbuildLocationMethod = version. Valeurs autorisées : latest, 17.0 (MSBuild 17.0), 16.0 (MSBuild 16.0), 15.0 (MSBuild 15.0), 14.0 (MSBuild 14.0), 12.0 (MSBuild 12.0), 4.0 (MSBuild 4.0). Valeur par défaut : 15.0.

Spécifie l’utilisation de la dernière version si la version par défaut est introuvable. Sur macOS, xbuild (Mono) ou MSBuild (Visual Studio pour Mac) sera utilisé.

msbuildFile - Emplacement MSBuild
Alias d’entrée : msbuildLocation. string. Nécessaire lorsque msbuildLocationMethod = location.

facultatif. Fournit le chemin d’accès à MSBuild (sur Windows) ou xbuild (sur macOS).

msbuildArchitectureOption - Architecture MSBuild
Alias d’entrée : msbuildArchitecture. string. facultatif. Utilisez quand msbuildLocationMethod = version. Valeurs autorisées : x86 (MSBuild x86), x64 (MSBuild x64). Valeur par défaut : x86.

Fournit l’architecture (x86, x64) du MSBuild que vous souhaitez exécuter.

msbuildArguments - Arguments supplémentaires
string.

Spécifie des arguments supplémentaires passés à MSBuild (sur Windows) ou xbuild (sur macOS).

jdkOption - Sélectionnez JDK à utiliser pour la build
Alias d’entrée : jdkSelection. string. Obligatoire. Valeurs autorisées : JDKVersion (version JDK), Path. Valeur par défaut : JDKVersion.

Spécifie la version du JDK que la tâche utilise pendant le processus de génération. La JDKVersion valeur spécifie une version du JDK que la tâche découvre pendant les builds. La Path valeur spécifie un chemin d’accès de fichier pour une version JDK.

jdkVersionOption - Version du JDK
Alias d’entrée : jdkVersion. string. facultatif. Utilisez quand jdkSelection = JDKVersion. Valeurs autorisées : default, 1.11 (JDK 11), 1.10 (JDK 10 (hors support)), 1.9 (JDK 9 (hors support)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (hors support)). Valeur par défaut : default.

Spécifie la version du JDK à utiliser pendant la génération.

jdkDirectory - Chemin JDK
Alias d’entrée : jdkUserInputPath. string. Nécessaire lorsque jdkSelection = Path.

Spécifie la version du JDK à utiliser pendant la génération au niveau du chemin d’accès jdkSelection .

jdkArchitectureOption - Architecture JDK
Alias d’entrée : jdkArchitecture. string. facultatif. Utilisez quand jdkVersion != default. Valeurs autorisées : x86, x64. Valeur par défaut : x64.

Fournit l’architecture (x86, x64) du JDK.

Options de contrôle de la tâche

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 pour créer une application Android avec Xamarin.

Exemples

• Générer votre application Xamarin

Configuration requise

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 : MSBuild, Xamarin.Android
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	1.83.0 ou version ultérieure
Catégorie de la tâche	Build