Stay organized with collections
Save and categorize content based on your preferences.
ManagedVirtualDevice
@Incubating interface ManagedVirtualDevice : Device
Device type for emulators to be managed by the Android Gradle Plugin.
When a device group containing this device is run for tests, Gradle will:
-
Automatically start up an emulator matching the device definition. Including downloading any and all required system image files and creating the avd.
-
Run the tests on this device.
-
Close the emulator upon completion.
These APIs are experimental and may change without notice.
Summary
Public properties |
Int |
The api level of Android to be run on the device.
|
String |
The hardware profile of the device to be emulated.
|
Boolean |
Whether the image must be a 64 bit image.
|
String |
Which source the system image should come from.
|
Public properties
apiLevel
var apiLevel: Int
The api level of Android to be run on the device.
This will default to the target api level of the application.
device
var device: String
The hardware profile of the device to be emulated.
require64Bit
var require64Bit: Boolean
Whether the image must be a 64 bit image. Defaults to false.
On x86_64 machines: When false, the managed device will use the 32 bit image if available with the given api level and source, otherwise the 64 bit image will be used. When true, the 64 image must be used and setup will fail if an appropriate image does not exist. On arm machines: The value of this parameter has no effect. An arm64 image is always selected.
systemImageSource
var systemImageSource: String
Which source the system image should come from. Either "google", "google-atd", "aosp", or "aosp-atd". You can also specify an explicit source such as "google_apis_playstore".
"google", the default, will select Google APIs images for the device. "google-atd" will use automated test device images from Google APIs. "aosp" will use the Android Open Source Project images for the device. "aosp-atd" will use automated test device image from the Android Open Source Project.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# ManagedVirtualDevice\n====================\n\n\n```\n@Incubating interface ManagedVirtualDevice : Device\n```\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nDevice type for emulators to be managed by the Android Gradle Plugin.\n\nWhen a device group containing this device is run for tests, Gradle will:\n\n1. Automatically start up an emulator matching the device definition. Including downloading any and all required system image files and creating the avd.\n\n2. Run the tests on this device.\n\n3. Close the emulator upon completion.\n\nThese APIs are experimental and may change without notice.\n\nSummary\n-------\n\n| ### Public properties ||\n|------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [apiLevel](/reference/tools/gradle-api/7.4/com/android/build/api/dsl/ManagedVirtualDevice#apiLevel()) The api level of Android to be run on the device. |\n| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [device](/reference/tools/gradle-api/7.4/com/android/build/api/dsl/ManagedVirtualDevice#device()) The hardware profile of the device to be emulated. |\n| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | [require64Bit](/reference/tools/gradle-api/7.4/com/android/build/api/dsl/ManagedVirtualDevice#require64Bit()) Whether the image must be a 64 bit image. |\n| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [systemImageSource](/reference/tools/gradle-api/7.4/com/android/build/api/dsl/ManagedVirtualDevice#systemImageSource()) Which source the system image should come from. |\n\n| ### Inherited functions ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| From class [org.gradle.api.Named](https://docs.gradle.org/current/javadoc/org/gradle/api/Named.html) |----------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------| | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [getName](https://docs.gradle.org/current/javadoc/org/gradle/api/Named.html#getName--)`()` | |\n\nPublic properties\n-----------------\n\n### apiLevel\n\n```\nvar apiLevel: Int\n```\n\nThe api level of Android to be run on the device.\n\nThis will default to the target api level of the application. \n\n### device\n\n```\nvar device: String\n```\n\nThe hardware profile of the device to be emulated. \n\n### require64Bit\n\n```\nvar require64Bit: Boolean\n```\n\nWhether the image must be a 64 bit image. Defaults to false.\n\nOn x86_64 machines: When false, the managed device will use the 32 bit image if available with the given api level and source, otherwise the 64 bit image will be used. When true, the 64 image must be used and setup will fail if an appropriate image does not exist. On arm machines: The value of this parameter has no effect. An arm64 image is always selected. \n\n### systemImageSource\n\n```\nvar systemImageSource: String\n```\n\nWhich source the system image should come from. Either \"google\", \"google-atd\", \"aosp\", or \"aosp-atd\". You can also specify an explicit source such as \"google_apis_playstore\".\n\n\"google\", the default, will select Google APIs images for the device. \"google-atd\" will use automated test device images from Google APIs. \"aosp\" will use the Android Open Source Project images for the device. \"aosp-atd\" will use automated test device image from the Android Open Source Project."]]
