AndroidBuild@1: Android Build v1-Aufgabe

Artikel
08/20/2024

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

Der AndroidBuild@1 Task 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.

Eingaben

gradleWrapper - Speicherort des Gradle Wrappers
string.

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

gradleProj - Projektverzeichnis
string.

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

gradleArguments - Gradle-Argumente
string. Standardwert. build.

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

avdName - Namen
string. Erforderlich. Standardwert. AndroidBuildEmulator.

Der Name des zu startenden oder zu erstellenden virtuellen Android-Geräts (AVD).

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

createAvd - Erstellen von AVD
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 Android Virtual Device (AVD) abzielt.

emulatorDevice - AVD-Gerät
string. Optional. Verwenden Sie , 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 die ABI-Verwaltung.

avdForce - Überschreiben vorhandener AVD
boolean. Optional. Verwenden Sie , wenn createAvd = true. Standardwert. false.

Überschreibt eine vorhandene AVD durch Übergeben --force an den android create avd Befehl.

avdOptionalArgs - Erstellen optionaler AVD-Argumente
string. Optional. Verwenden Sie , wenn createAvd = true.

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

startEmulator - Starten und Beenden des Android-Emulators
boolean. Standardwert. false.

Startet und beendet den Android-Emulator, nachdem der Android-Buildtask abgeschlossen ist.

Sie müssen Ihren eigenen Agent bereitstellen, um diesen booleschen Wert verwenden zu können. 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 auf den Start des Emulators wartet.

emulatorHeadless - Headless-Anzeige
boolean. Optional. Verwenden Sie , wenn startEmulator = true. Standardwert. false.

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

emulatorOptionalArgs - Optionale Emulatorargumente
string. Optional. Verwenden Sie , wenn startEmulator = true. Standardwert. -no-snapshot-load -no-snapshot-save.

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

deleteAvd - Löschen von AVD
boolean. Optional. Verwenden Sie , wenn startEmulator = true. Standardwert. false.

Löscht die AVD nach Abschluss der Aufgabe.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen , um Aufträge auszuführen, die diese Aufgabe verwenden: AndroidSDK
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	1.83.0 oder höher
Aufgabenkategorie	Entwickeln

Freigeben über