AndroidBuild@1 — zadanie kompilacji systemu Android w wersji 1

Artykuł
03/24/2025

Użyj tego zadania, aby skompilować aplikację systemu Android przy użyciu narzędzia Gradle i (opcjonalnie) uruchomić emulator na potrzeby testów jednostkowych.

Zadanie AndroidBuild@1 jest przestarzałe. Zamiast tego użyj zadania Gradle.

Składnia

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

Dane wejściowe

gradleWrapper - lokalizacja otoki Gradle
string.

Lokalizacja otoki gradlew używanej do kompilacji. Agenci w systemie Windows (w tym agenci hostowani przez firmę Microsoft) muszą używać otoki gradlew.bat. Agenci w systemie Linux lub macOS mogą używać skryptu powłoki gradlew. Dowiedz się więcej o otoki Gradle.

katalogu projektów gradleProj -
string.

Ścieżka względna z katalogu głównego repozytorium do katalogu głównego aplikacji. Najprawdopodobniej będzie to miejsce, w którym znajduje się plik build.gradle.

gradleArguments - argumenty narzędzia Gradle
string. Wartość domyślna: build.

Udostępnia wszelkie opcje przekazywania do wiersza polecenia narzędzia Gradle. Dowiedz się więcej na temat wiersza polecenia Gradle.

avdName - nazwa
string. To jest wymagane. Wartość domyślna: AndroidBuildEmulator.

Nazwa urządzenia wirtualnego z systemem Android (AVD) do uruchomienia lub utworzenia.

Aby użyć tego ciągu, musisz wdrożyć własnego agenta. Nie można użyć puli hostowanej przez firmę Microsoft, jeśli chcesz utworzyć usługę AVD.

createAvd - Tworzenie AVD
boolean. Wartość domyślna: AndroidBuildEmulator.

Tworzy nazwane urządzenie wirtualne z systemem Android (AVD).

zestaw SDK usługi emulatorTarget - AVD target
string. Wymagane, gdy createAvd = true. Wartość domyślna: android-19.

Wersja zestawu Android SDK przeznaczona dla urządzenia wirtualnego z systemem Android (AVD).

emulatorDevice - urządzenia AVD
string. Opcjonalny. Użyj polecenia , gdy createAvd = true. Wartość domyślna: Nexus 5.

Potok urządzenia, który może być używany. Może to być indeks urządzenia lub identyfikator.

avdAbi - AVD ABI
string. Wymagane, gdy createAvd = true. Wartość domyślna: default/armeabi-v7a.

Interfejs binarny aplikacji (ABI) do użycia dla urządzenia wirtualnego z systemem Android (AVD). Dowiedz się więcej o usłudze ABI Management.

avdForce - zastąpić istniejące AVD
boolean. Opcjonalny. Użyj polecenia , gdy createAvd = true. Wartość domyślna: false.

Zastępuje istniejącą usługę AVD, przekazując --force do polecenia android create avd.

avdOptionalArgs - tworzenie opcjonalnych argumentów usługi AVD
string. Opcjonalny. Użyj polecenia , gdy createAvd = true.

Tworzy dodatkowe argumenty do przekazania do android create avd.

startEmulator - uruchamianie i zatrzymywanie emulatora systemu Android
boolean. Wartość domyślna: false.

Uruchamia i zatrzymuje emulator systemu Android po zakończeniu zadania kompilacji systemu Android.

Musisz wdrożyć własnego agenta, aby używać tego wartości logicznej. Nie można użyć puli hostowanej przez firmę Microsoft, jeśli chcesz użyć emulatora. Dowiedz się więcej o agentach usługi Azure Pipeline.

limit czasu emulatorTimeout - w sekundach
string. Wymagane, gdy startEmulator = true. Wartość domyślna: 300.

Określa, jak długo (w sekundach) kompilacja będzie czekać na uruchomienie emulatora.

emulatorHeadless - wyświetlacz bezgłowy
boolean. Opcjonalny. Użyj polecenia , gdy startEmulator = true. Wartość domyślna: false.

Uruchamia emulator bez graficznego interfejsu użytkownika (tryb bez nagłówka) przy użyciu wartości -no-skin -no-audio -no-window.

Opcjonalne argumenty emulatora emulatorOptionalArgs -
string. Opcjonalny. Użyj polecenia , gdy startEmulator = true. Wartość domyślna: -no-snapshot-load -no-snapshot-save.

Udostępnia dodatkowe argumenty do przekazania do polecenia emulator.

deleteAvd - usuń AVD
boolean. Opcjonalny. Użyj polecenia , gdy startEmulator = true. Wartość domyślna: false.

Usuwa avD po zakończeniu zadania.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do uruchamiania zadań korzystających z tego zadania: AndroidSDK
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.83.0 lub nowsza
Kategoria zadań	Zbuduj

Udostępnij za pośrednictwem