Skip to content

Latest commit

 

History

History
88 lines (59 loc) · 4.26 KB

REGISTRY.MD

File metadata and controls

88 lines (59 loc) · 4.26 KB
Raw

Android Emulator

The Android Emulator simulates Android devices on your computer so that you can test your application on a variety of devices and Android API levels without needing to have each physical device.

The emulator provides almost all of the capabilities of a real Android device. You can simulate incoming phone calls and text messages, specify the location of the device, simulate different network speeds, simulate rotation and other hardware sensors, access the Google Play Store, and much more.

Testing your app on the emulator is in some ways faster and easier than doing so on a physical device.

Requirements and recommendations

The docker images have the following requirements:

  • Linux only. Launching the emulator in Windows or MacOS is not supported.

  • KVM must be available. You can get access to KVM by running on "bare metal", or on a (virtual) machine that provides nested virtualization. If you are planning to run this in the cloud (gce/azure/aws/etc..) you first must make sure you have access to KVM. Details on how to get access to KVM on the various cloud providers can be found here:

    • AWS provides bare metal instances that provide access to KVM.
    • Azure: Follow these instructions to enable nested virtualization.
    • GCE: Follow these instructions to enable nested virtualization.

Keep in mind that you will see reduced performance if you are making use of nested virtualization.

Available images.

Here is a list of the latest images.

  • us-docker.pkg.dev/android-emulator-268719/images/28-playstore-x64:30.1.2
  • us-docker.pkg.dev/android-emulator-268719/images/28-playstore-x64-no-metrics:30.1.2
  • us-docker.pkg.dev/android-emulator-268719/images/29-google-x64:30.1.2
  • us-docker.pkg.dev/android-emulator-268719/images/29-google-x64-no-metrics:30.1.2
  • us-docker.pkg.dev/android-emulator-268719/images/30-google-x64:30.1.2
  • us-docker.pkg.dev/android-emulator-268719/images/30-google-x64-no-metrics:30.1.2

For example you can now pull a container as follows:

docker pull us-docker.pkg.dev/android-emulator-268719/images/28-playstore-x64:30.1.2

Usage

The following environment variables are accepted by the emulator:

  • ADBKEY This is the private adb key, needed if you wish to make use of adb. ADB is available on port 5555.

The following ports are available:

An example invocation making the console, adb and the gRPC endpoint available:

docker run -e "ADBKEY=$(cat ~/.android/adbkey)" --device /dev/kvm --publish 8554:8554/tcp --publish 5554:5554/tcp --publish 5555:5555/tcp us-docker.pkg.dev/android-emulator-268719/images/28-playstore-x64:30.1.2

You might need to run adb connect localhost:5555 to enable ADB to discover the device.

License

By making use of this container you accept the Android Sdk License

The android emulator is released under the Apache-2 license.

The notices for the emulator and system image can be found in the following directories:

  • /android/sdk/system-images/android/x86_64/NOTICE.txt
  • /android/sdk/system-images/android/x86/NOTICE.txt
  • /android/sdk/emulator/NOTICE.txt

You can extract the notices as follows:

CONTAINER_ID=$(docker create name_of_image)
docker export $CONTAINER_ID | tar vxf -  --wildcards --no-anchored 'NOTICE.txt'

For containers that do not have the -no-metrics you accept the following:

By using this docker container you authorize Google to collect usage data for the Android Emulator — such as how you utilize its features and resources, and how you use it to test applications. This data helps improve the Android Emulator and is collected in accordance with Google's Privacy Policy