Docker-Android is a docker image built to be used for everything related to mobile website testing and Android project.
Emulator - Samsung Device | Emulator - Nexus Device | Real Device |
---|---|---|
![]() |
![]() |
![]() |
- Run UI tests for mobile websites with appium
- Build Android project and run unit tests with the latest build-tools
- Run UI tests for Android applications with different frameworks (appium, espresso, robotium, etc.)
- Run monkey / stress tests
- SMS testing
- noVNC to see what happen inside docker container
- Emulator for different devices / skins, such as Samsung Galaxy S6, LG Nexus 4, HTC Nexus One and more.
- Ability to connect to Selenium Grid
- Ability to control emulator from outside container by using adb connect
- Support real devices with screen mirroring
- Ability to record video during test execution for debugging
- Open source with more features coming
Type | Device Name |
---|---|
Phone | Samsung Galaxy S6 |
Phone | Nexus 4 |
Phone | Nexus 5 |
Phone | Nexus One |
Phone | Nexus S |
Tablet | Nexus 7 |
Docker is installed in your system.
-
Run docker-android
-
For Linux OS, please use image name that contains "x86"
docker run --privileged -d -p 6080:6080 -p 5554:5554 -p 5555:5555 -e DEVICE="Samsung Galaxy S6" --name android-container butomo1989/docker-android-x86-7.1.1
-
For OSX and Windows OS, please use image name that contains "arm"
docker run --privileged -d -p 6080:6080 -p 5554:5554 -p 5555:5555 -e DEVICE="Samsung Galaxy S6" --name android-container butomo1989/docker-android-arm-7.1.1
-
-
Verify the ip address of docker host.
-
For OSX, you can find out by using following command:
docker-machine ip default
-
For different OS, localhost should work.
-
-
Open http://docker-host-ip-address:6080 from web browser.
Appium is automation test framework to test mobile website and mobile application, including android. To be able to use appium, you need to run appium-server. You run appium server inside docker-android container by opening port 4723 and passing an environment variable APPIUM=TRUE.
docker run --privileged -d -p 6080:6080 -p 5554:5554 -p 5555:5555 -p 4723:4723 -e DEVICE="Samsung Galaxy S6" -e APPIUM=True --name android-container butomo1989/docker-android-x86-7.1.1
It is also possible to connect appium server that run inside docker-android with selenium grid by passing following environment variables:
- CONNECT_TO_GRID=True
- APPIUM_HOST="<host_ip_address>"
- APPIUM_PORT=<port_number>
- SELENIUM_HOST="<host_ip_address>"
- SELENIUM_PORT=<port_number>
To run tests for mobile browser, following parameter can be passed:
- MOBILE_WEB_TEST=True
docker run --privileged -d -p 6080:6080 -p 4723:4723 -p 5554:5554 -p 5555:5555 -e DEVICE="Samsung Galaxy S6" -e APPIUM=True -e CONNECT_TO_GRID=True -e APPIUM_HOST="127.0.0.1" -e APPIUM_PORT=4723 -e SELENIUM_HOST="172.17.0.1" -e SELENIUM_PORT=4444 -e MOBILE_WEB_TEST=True --name android-container butomo1989/docker-android-x86-7.1.1
If you want to use appium to test UI of your android application, you need to share volume where the APK is located to folder /root/tmp.
docker run --privileged -d -p 6080:6080 -p 4723:4723 -p 5554:5554 -p 5555:5555 -v $PWD/example/sample_apk:/root/tmp -e DEVICE="Nexus 5" -e APPIUM=True -e CONNECT_TO_GRID=True -e APPIUM_HOST="127.0.0.1" -e APPIUM_PORT=4723 -e SELENIUM_HOST="172.17.0.1" -e SELENIUM_PORT=4444 --name android-container butomo1989/docker-android-x86-7.1.1
You can deactivate auto_record by changing the value to "False" in docker-compose file. e.g. change value to "False" in this line.
There is example of compose file to run complete selenium grid and docker-android container as nodes. docker-compose version 1.13.0 or higher is required to be able to execute that compose file.
docker-compose up -d
docker-android can be used for building Android project and executing its unit test. This following steps will illustrate how to build Android project:
-
Clone this sample test project.
git clone [email protected]:googlesamples/android-testing.git
-
Build the project
docker run -it --rm -v $PWD/android-testing/ui/espresso/BasicSample:/root/tmp butomo1989/docker-android-x86-7.1.1 tmp/gradlew build
adb connect <docker-machine-ip-address>:5555
Note: You need to have Android Debug Bridge (adb) installed in your host machine.
-
Using telnet
- Find the auth_token and copy it.
docker exec -it android-container cat /root/.emulator_console_auth_token
- Access emulator using telnet and login with auth_token
telnet <docker-machine-ip-address> 5554
- Login with given auth_token from 1.step
auth <auth_token>
- Send the sms
sms send <phone_number> <message>
-
Using adb
docker exec -it android-container adb emu sms send <phone_number> <message>
-
You can also integrate it inside project using adb library.
The following instructions are used for OS X. You'll need docker-machine-parallels to create a virtual machine (vm) with tiny core linux for running docker images. After that, you may start the vm you created for VMWare Fusion or Parallels Desktop and run a docker container inside this vm. If you're going to use the android docker of emulator with x86 processor, setup this vm for nested virtualization and kvm support before you run a docker container.
- Install docker-machine-parallels via Homebrew:
$ brew install docker-machine-parallels
- Create a virtual machine for running docker images based on the virtual machine tool you use
Create a virtual machine of VMWare Fusion
$ docker-machine create --driver=vmwarefusion vmware-dev
Create a virtual machine of Parallels Desktop
$ docker-machine create --driver=parallels prl-dev
This utility docker-machine-parallels
will fetch boot2docker.iso to create a vm of VMWare fusion or Parallels Desktop. When the vm is created, you'll see it's booted with VMWare fusion or Parallels Desktop where the network of vm is set to NAT and one IP is assigned. You'll be able to connect to vnc service inside the docker image through that IP. Say it's 10.211.55.3
and we'll use it later.
- Setup the virtual machine for nested virtualization support
Shutdown the vm by running the command below in the boot2docker vm before you setup it.
# shutdown -h now
If you use VMWare Fusion, go to menu bar > Vitual Machine > Settings > Processors and Memory, expand Advanced options, and select Enable hypervisor applications in this virtual machine
.
If you use Parallels Desktop, open settings screen of that vm and go to CPU & Memory
under hardware
tab, expand Advanced settings and select Enable nested virtualization
.
- Enable kvm inside virtual machine Run as an account other than root to install kvm packages using tce-load.
# su docker
$ tce-load -wi kvm
Run as root to load kvm module after kvm packages install.
$ sudo modprobe kvm_intel
Check if the kvm device is loaded.
$ ls /dev/kvm
Check if your CPU supports hardware virtualization now
$ egrep -c '(vmx|svm)' /proc/cpuinfo
If 0 it means that your CPU doesn't support hardware virtualization.
If 1 or more it does - but you still need to make sure that virtualization is enabled in the BIOS.
- You may now run a docker container Let's run a docker image for an emulator with x86 processor.
docker run --privileged -d -p 6080:6080 -p 5554:5554 -p 5555:5555 -e DEVICE="Samsung Galaxy S6" --name android-container butomo1989/docker-android-x86-7.1.1
When the services inside this docker container are running, connect to http://10.211.55.3:6080/vnc.html (the IP we got when the docker machine was created) and login. The emulator with x86 processor should be running on screen.
All logs inside container are stored under folder /var/log/supervisor. you can print out log file by using docker exec. Example:
docker exec -it android-container tail -f /var/log/supervisor/docker-android.stdout.log
- Gian Christanto for creating a great logo!