AndroidBuild@1 - Tâche Android Build v1

Article
08/19/2024

Utilisez cette tâche pour créer une application Android à l’aide de Gradle et (éventuellement) démarrer l’émulateur pour les tests unitaires.

La tâche AndroidBuild@1 est déconseillée. Utilisez plutôt la tâche Gradle .

Syntax

# Android Build v1
# AndroidBuild@1 is deprecated. Use Gradle.
- task: AndroidBuild@1
  inputs:
    #gradleWrapper: # string. Location of Gradle Wrapper. 
    #gradleProj: # string. Project Directory. 
    #gradleArguments: 'build' # string. Gradle Arguments. Default: build.
  # Android Virtual Device (AVD) Options
    avdName: 'AndroidBuildEmulator' # string. Required. Name. Default: AndroidBuildEmulator.
    #createAvd: AndroidBuildEmulator # boolean. Create AVD. Default: AndroidBuildEmulator.
    #emulatorTarget: 'android-19' # string. Required when createAvd = true. AVD Target SDK. Default: android-19.
    #emulatorDevice: 'Nexus 5' # string. Optional. Use when createAvd = true. AVD Device. Default: Nexus 5.
    #avdAbi: 'default/armeabi-v7a' # string. Required when createAvd = true. AVD ABI. Default: default/armeabi-v7a.
    #avdForce: false # boolean. Optional. Use when createAvd = true. Overwrite Existing AVD. Default: false.
    #avdOptionalArgs: # string. Optional. Use when createAvd = true. Create AVD Optional Arguments. 
  # Emulator Options
    #startEmulator: false # boolean. Start and Stop Android Emulator. Default: false.
    #emulatorTimeout: '300' # string. Required when startEmulator = true. Timeout in Seconds. Default: 300.
    #emulatorHeadless: false # boolean. Optional. Use when startEmulator = true. Headless Display. Default: false.
    #emulatorOptionalArgs: '-no-snapshot-load -no-snapshot-save' # string. Optional. Use when startEmulator = true. Emulator Optional Arguments. Default: -no-snapshot-load -no-snapshot-save.
    #deleteAvd: false # boolean. Optional. Use when startEmulator = true. Delete AVD. Default: false.

Entrées

gradleWrapper - Emplacement du wrapper Gradle
string.

Emplacement du gradlew wrapper utilisé pour la build. Les agents sur Windows (y compris les agents hébergés par Microsoft) doivent utiliser le gradlew.bat wrapper. Les agents sur Linux ou macOS peuvent utiliser le script shell gradlew. En savoir plus sur le wrapper Gradle.

gradleProj - Répertoire du projet
string.

Chemin relatif de la racine du référentiel au répertoire racine de l’application. Il s’agit probablement de l’emplacement où se trouve le build.gradle fichier.

gradleArguments - Gradle Arguments
string. Valeur par défaut : build.

Fournit toutes les options à passer à la ligne de commande Gradle. En savoir plus sur la ligne de commande Gradle.

avdName - Nom
string. Obligatoire. Valeur par défaut : AndroidBuildEmulator.

Nom de l’appareil virtuel Android (AVD) à démarrer ou à créer.

Vous devez déployer votre propre agent pour utiliser cette chaîne. Vous ne pouvez pas utiliser un pool hébergé par Microsoft si vous souhaitez créer un appareil virtuel Android.

createAvd - Créer AVD
boolean. Valeur par défaut : AndroidBuildEmulator.

Crée l’appareil virtuel Android (AVD) nommé.

emulatorTarget - KIT de développement logiciel (SDK) cible AVD
string. Nécessaire lorsque createAvd = true. Valeur par défaut : android-19.

Version du Kit de développement logiciel (SDK) Android que l’appareil virtuel Android (AVD) cible.

emulatorDevice - Appareil AVD
string. facultatif. Utilisez quand createAvd = true. Valeur par défaut : Nexus 5.

Pipeline d’appareil qui peut être utilisé. Il peut s’agir d’un index d’appareil ou d’un ID.

avdAbi - AVD ABI
string. Nécessaire lorsque createAvd = true. Valeur par défaut : default/armeabi-v7a.

Interface binaire d’application (ABI) à utiliser pour l’appareil virtuel Android (AVD). En savoir plus sur ABI Management.

avdForce - Remplacer l’AVD existant
boolean. facultatif. Utilisez quand createAvd = true. Valeur par défaut : false.

Remplace un AVD existant en passant --force à la android create avd commande .

avdOptionalArgs - Créer des arguments facultatifs AVD
string. facultatif. Utilisez quand createAvd = true.

Crée des arguments supplémentaires à passer à android create avd.

startEmulator - Démarrer et arrêter l’émulateur Android
boolean. Valeur par défaut : false.

Démarre et arrête l’émulateur Android une fois la tâche de génération Android terminée.

Vous devez déployer votre propre agent pour utiliser ce booléen. Vous ne pouvez pas utiliser un pool hébergé par Microsoft si vous souhaitez utiliser un émulateur. En savoir plus sur les agents Azure Pipeline.

emulatorTimeout - Délai d’expiration en secondes
string. Nécessaire lorsque startEmulator = true. Valeur par défaut : 300.

Définit la durée (en secondes) pendant laquelle la build attend le démarrage de l’émulateur.

emulatorHeadless - Affichage sans tête
boolean. facultatif. Utilisez quand startEmulator = true. Valeur par défaut : false.

Démarre l’émulateur sans interface graphique (mode sans tête) à l’aide de la -no-skin -no-audio -no-window valeur .

emulatorOptionalArgs - Arguments facultatifs de l’émulateur
string. facultatif. Utilisez quand startEmulator = true. Valeur par défaut : -no-snapshot-load -no-snapshot-save.

Fournit des arguments supplémentaires à passer à la emulator commande.

deleteAvd - Supprimer AVD
boolean. facultatif. Utilisez quand startEmulator = true. Valeur par défaut : false.

Supprime l’AVD à l’achèvement de la tâche.

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.

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

Partager via