AndroidBuild@1 - Attività Android Build v1

Articolo
03/24/2025

Usare questa attività per compilare un'app Android usando Gradle e (facoltativamente) avviare l'emulatore per gli unit test.

L'attività AndroidBuild@1 è deprecata. Usare invece l'attività Gradle.

Sintassi

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

Ingressi dati

gradleWrapper - posizione del wrapper Gradle
string.

Posizione del wrapper gradlew utilizzato per la compilazione. Gli agenti in Windows (inclusi gli agenti ospitati da Microsoft) devono usare il wrapper gradlew.bat. Gli agenti in Linux o macOS possono usare lo script della shell gradlew. Altre informazioni su il wrapper Gradle.

gradleProj - Project Directory
string.

Percorso relativo dalla radice del repository alla directory radice dell'applicazione. È molto probabile che si trovi il file build.gradle.

gradleArguments - argomenti Gradle
string. Valore predefinito: build

Fornisce tutte le opzioni da passare alla riga di comando gradle. Altre informazioni sulla riga di comando Gradle.

avdName - Nome
string. Obbligatorio. Valore predefinito: AndroidBuildEmulator

Nome del dispositivo virtuale Android (AVD) da avviare o creare.

Per usare questa stringa, è necessario distribuire il proprio agente. Non è possibile usare un pool ospitato da Microsoft se si vuole creare un AVD.

createAvd - Creare AVD
boolean. Valore predefinito: AndroidBuildEmulator

Crea il dispositivo virtuale Android denominato ( AVD).

emulatorTarget - SDK di destinazione AVD
string. Obbligatorio quando createAvd = true. Valore predefinito: android-19

Versione di Android SDK destinata al dispositivo virtuale Android (AVD).

emulatorDevice - del dispositivo AVD
string. Opzionale. Usare quando createAvd = true. Valore predefinito: Nexus 5

Pipeline del dispositivo che può essere usata. Può trattarsi di un indice del dispositivo o di un ID.

avdAbi - ABI AVD
string. Obbligatorio quando createAvd = true. Valore predefinito: default/armeabi-v7a

Application Binary Interface (ABI) da usare per il dispositivo virtuale Android (AVD). Altre informazioni su Gestione ABI.

avdForce - sovrascrivere AVD esistenti
boolean. Opzionale. Usare quando createAvd = true. Valore predefinito: false

Sovrascrive un AVD esistente passando --force al comando android create avd.

avdOptionalArgs - creare argomenti facoltativi AVD
string. Opzionale. Usare quando createAvd = true.

Crea argomenti aggiuntivi da passare a android create avd.

startEmulator - Avviare e arrestare l'emulatore Android
boolean. Valore predefinito: false

Avvia e arresta l'emulatore Android al termine dell'attività Di compilazione Android.

Per usare questo valore booleano, è necessario distribuire il proprio agente. Non è possibile usare un pool ospitato da Microsoft se si vuole usare un emulatore. Altre informazioni sugli agenti di Azure Pipeline .

emulatorTimeout - timeout in secondi
string. Obbligatorio quando startEmulator = true. Valore predefinito: 300

Definisce per quanto tempo (in secondi) la compilazione attenderà l'avvio dell'emulatore.

emulatorHeadless - display headless
boolean. Opzionale. Usare quando startEmulator = true. Valore predefinito: false

Avvia l'emulatore senza GUI (modalità headless) usando il valore -no-skin -no-audio -no-window.

argomenti facoltativi dell'emulatore emulatorOptionalArgs -
string. Opzionale. Usare quando startEmulator = true. Valore predefinito: -no-snapshot-load -no-snapshot-save

Fornisce argomenti aggiuntivi da passare al comando emulator.

deleteAvd - eliminare AVD
boolean. Opzionale. Usare quando startEmulator = true. Valore predefinito: false

Elimina l'AVD al completamento dell'attività.

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.

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à: AndroidSDK
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	1.83.0 o versione successiva
Categoria attività	Costruire

Condividi tramite