Skip to content

Headless Android x86 emulator ready for automated instrumentation testing.

Notifications You must be signed in to change notification settings

thedrhax-dockerfiles/android-avd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 

Repository files navigation

Android Virtual Device for Docker

This image contains the latest version of Android SDK with configured AVD.

Supported tags and respective Dockerfile links

Examples

  • Basic usage
docker run -it --rm --name avd --device /dev/kvm thedrhax/android-avd

# Use ADB to interact with virtual device
docker exec -it avd adb shell
  • Remote ADB connection
docker run -it --rm --device /dev/kvm -p 5554:5554 -p 5555:5555 thedrhax/android-avd

# Connect local ADB process to AVD (not required if both are on localhost)
adb connect IP_OF_AVD_CONTAINER_OR_HOST

# Use ADB to interact with virtual device
adb shell
  • Automated instrumentation testing via Gradle, Android Studio, etc.
# Install socat
sudo apt-get install socat

# Bind container's port 5555 to localhost
socat tcp-listen:5555,bind=127.0.0.1,fork tcp:IP_OF_AVD_CONTAINER:5555 & PID=$!

# Run Gradle tests
gradle connectedAndroidTest
# or use ADB without connecting to remote AVD
adb shell
# or just use AVD in Android Studio

# Kill socat
kill $PID
  • Interact with AVD via VNC
docker run -it --device /dev/kvm -p 5900:5900 thedrhax/android-avd

# Use any VNC client to connect to localhost:5900, for example:
ssvncviewer localhost:5900
  • Interact with AVD via noVNC (HTML5 VNC client)
docker run -it --device /dev/kvm --env noVNC=true -p 6080:6080 thedrhax/android-avd

# Open http://localhost:6080/vnc.html in your browser
xdg-open http://localhost:6080/vnc.html

Note: --device /dev/kvm flag is required to enable CPU hardware acceleration. You may also need to activate kvm kernel module on your host machine: modprobe kvm, or even install it first.

About

Headless Android x86 emulator ready for automated instrumentation testing.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published