amrka/android-emulator repository overview

⁠Android emulator Image

The use of this Docker image simplifies the process of running an Android emulator within a Docker container. This can be achieved through a few basic commands or by utilizing a simple Docker compose file. The image includes the latest version of the Android SDK, as well as the Appium server, which allows for the execution of mobile automation tests.

https://github.com/amrsa1/Android-Emulator⁠

⁠Feature

• Run android emulator in headless or in headed mode (through VNC)
• Support Appium driver
• Come with the latest JDK lts.

⁠Setup

⁠Manual execution

Down below is the list of the main scripts to launch the relevant service, certain environment variables should be passed during starting the container.

1. build the docker image :

   docker build android-emulator .
   

   Copy

   OR for customized image

   docker build \
   --build-arg ARCH=x86_64  \
   --build-arg TARGET=google_apis_playstore\
   --build-arg API_LEVEL=31 \
   --build-arg BUILD_TOOLS=31.0.0 \
   --build-arg EMULATOR_DEVICE="Nexus 6" \
   --build-arg EMULATOR_NAME=nexus \
   -t my-android-image .  
   

   Copy

2. Start your container:

   docker run -it --privileged -d -p 5900:5900 --name androidContainer --privileged android-emulator  
   

   Copy

3. Launch the appium session :

   docker exec --privileged -it androidContainer bash -c "appium -p 5900"
   

   Copy

   OR

   docker exec --privileged  -it androidContainer bash -c "./start_appium.sh"
   

   Copy

4. Start the emulator in headless mode :

   docker exec --privileged -it -e EMULATOR_TIMEOUT=300 androidContainer bash -c "./start_emu_headless.sh"
   

   Copy

5. Starting VNC server:

   docker exec --privileged -it androidContainer bash -c "./start_vnc.sh"
   

   Copy

⁠Launch emulator in headed mode

1. The following command must be used to initiate the Docker container:

   docker run -it -d -p 5900:5900 --name androidContainer -e VNC_PASSWORD=password --privileged android-emulator
   

   Copy

2. Instantiate the VNC service by running:

   docker exec --privileged -it androidContainer bash -c "./start_vnc.sh"
   

   Copy

3. Connect to the VNC server via remmina or any VNC viewer, on:

   localhost:5900
   

   Copy

4. Open dash terminal in vnc viewer and right the following command:

   #: ./start_emu.sh
   

   Copy

*Note:

• The "start_emu.sh" script will start the emulator in a visible mode, therefore it should not be used for integration with a pipeline such as GitHub Actions or CircleCI. Instead, use the "start_emu_headless.sh" script.
• By default, Running emulator is 'Nexus 6' (emulator name: nexus) (Android 13)
• It is not necessary to launch all services in the docker-compose file, instead you should only enable the services you require, and comment out the others in the file.

⁠Using Docker-compose

The Docker Compose file simplifies the process of starting the service. It includes multiple services, such as launching the emulator with the Appium instance or launching the VNC server. You have the flexibility to enable or disable any service based on your needs.

docker compose up

⁠Environments

When manually starting the container, ensure to set the necessary environment variables for proper operation

⁠Kill the container

• Run the following command to kill and remove the container:

  docker rm -f androidContainer
  

  Copy