Freigeben über


AndroidBuild@1 – Android Build v1-Aufgabe

Verwenden Sie diese Aufgabe, um eine Android-App mit Gradle zu erstellen und (optional) den Emulator für Komponententests zu starten.

Die AndroidBuild@1 Aufgabe ist veraltet. Verwenden Sie stattdessen die Gradle-Aufgabe.

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.

Eingänge

gradleWrapper - Position des Gradle Wrapper-
string.

Der Speicherort des gradlew Wrappers, der für den Build verwendet wird. Agents unter Windows (einschließlich von Microsoft gehosteter Agents) müssen den gradlew.bat Wrapper verwenden. Agents unter Linux oder macOS können das gradlew Shellskript verwenden. Erfahren Sie mehr über gradle Wrapper.


gradleProj - Project Directory-
string.

Der relative Pfad vom Repositorystamm zum Stammverzeichnis der Anwendung. Dies ist wahrscheinlich der Ort, an dem sich die build.gradle Datei befindet.


gradleArguments - Gradle-Argumente
string. Standardwert: build.

Stellt alle Optionen bereit, die an die Befehlszeile von Gradle übergeben werden sollen. Erfahren Sie mehr über die Gradle-Befehlszeile.


avdName - Name
string. Erforderlich. Standardwert: AndroidBuildEmulator.

Der Name des virtuellen Android-Geräts (AVD), das gestartet oder erstellt werden soll.

Sie müssen Ihren eigenen Agent bereitstellen, um diese Zeichenfolge zu verwenden. Sie können keinen von Microsoft gehosteten Pool verwenden, wenn Sie eine AVD erstellen möchten.


createAvd - AVD- erstellen
boolean. Standardwert: AndroidBuildEmulator.

Erstellt das benannte virtuelle Android-Gerät (AVD).


emulatorTarget - AVD-Ziel-SDK-
string. Erforderlich, wenn createAvd = true. Standardwert: android-19.

Die Android SDK-Version, auf die das virtuelle Android-Gerät (AVD) ausgerichtet ist.


emulatorDevice - AVD-Gerät
string. Wahlfrei. Wird verwendet, wenn createAvd = true. Standardwert: Nexus 5.

Die Gerätepipeline, die verwendet werden kann. Dies kann ein Geräteindex oder eine ID sein.


avdAbi - AVD ABI-
string. Erforderlich, wenn createAvd = true. Standardwert: default/armeabi-v7a.

Die Application Binary Interface (ABI), die für das virtuelle Android-Gerät (AVD) verwendet werden soll. Erfahren Sie mehr über ABI Management.


avdForce - Vorhandene AVD- überschreiben
boolean. Wahlfrei. Wird verwendet, wenn createAvd = true. Standardwert: false.

Überschreibt eine vorhandene AVD, indem --force an den Befehl android create avd übergeben wird.


avdOptionalArgs - Optionale AVD-Argumente erstellen
string. Wahlfrei. Wird verwendet, wenn createAvd = true.

Erstellt zusätzliche Argumente, die an android create avdübergeben werden sollen.


startEmulator - Android-Emulator starten und beenden
boolean. Standardwert: false.

Startet den Android-Emulator und beendet den Android-Emulator, nachdem die Android Build-Aufgabe abgeschlossen wurde.

Sie müssen Ihren eigenen Agent bereitstellen, um diesen booleschen Wert zu verwenden. Sie können keinen von Microsoft gehosteten Pool verwenden, wenn Sie einen Emulator verwenden möchten. Erfahren Sie mehr über Azure Pipeline-Agents.


emulatorTimeout - Timeout in Sekunden
string. Erforderlich, wenn startEmulator = true. Standardwert: 300.

Definiert, wie lange (in Sekunden) der Build wartet, bis der Emulator gestartet wird.


emulatorHeadless - Headless-Anzeige
boolean. Wahlfrei. Wird verwendet, wenn startEmulator = true. Standardwert: false.

Startet den Emulator ohne GUI (Headless Mode) mithilfe des -no-skin -no-audio -no-window-Werts.


emulatorOptionalArgs - Emulator optionale Argumente
string. Wahlfrei. Wird verwendet, wenn startEmulator = true. Standardwert: -no-snapshot-load -no-snapshot-save.

Stellt zusätzliche Argumente bereit, die an den Befehl emulator übergeben werden.


deleteAvd - AVD- löschen
boolean. Wahlfrei. Wird verwendet, wenn startEmulator = true. Standardwert: false.

Löscht die AVD nach Abschluss des Vorgangs.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, klassischer Build
Läuft auf Agent, DeploymentGroup
Anforderungen Selbst gehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen, Aufträge ausführen, die diese Aufgabe verwenden: AndroidSDK
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 1.83.0 oder höher
Vorgangskategorie Bauen