Docker image for Appium (and Node) + Rspec (Ruby) + ADB (Android SDK)

Forget the pain of setting up node, appium, ruby, rvm...etc before being able to write test with Appium, Docker is here to the rescue. Now you just need to install Docker components and start running your test suites without the hesitate of installation (which might be a bit unfamiliar to Mobile Developers, maybe not familiar with Docker too, but this setup is promised to be less error prone and easy to replicate!).

This docker image includes:

Install Docker Engine
Clone and cd to this Repository.
Start building the Docker image:

$ docker build . --tag appspec:latest // change the image name and tag as you wish --tag [image_name]:[version]
When everything is done, Run a container from that image:

$ docker run --privileged -d -p 4723:4723 -e REMOTE_ADB=true -e ANDROID_DEVICES=docker.for.mac.localhost:5555 --name appspec-container -i appspec:latest // change the container [name:version] as you wish, simply replace appspec:latest
Arg explanation:
- Port 4723 is opened for Appium connection
- ANDROID_DEVICES is the IP of the host emulator, with our current setup, the emulator is supposed to run on host machine at port 5555. docker.for.mac.localhost is a special designed loopback address to help communicating from docker container to the host's localhost easier.
- At init, the container will automatically provision for the emulator connection and starting Appium server.
Validate the setup:
- Check if appium server is up: curl or access via browser: http://localhost:4723
- Check if the adb inside container has connected to the emulator:
  
  $ docker exec -it appspec-container adb devices -> there should be a list showing that specific emulator connected (via its IP address).

The current setup might have missed some Android SDK tools, but intentionally we won't provide much Android dependencies here, so make sure you had built APK for testing first.
Copy the Project into this container:

$ docker cp path/to/your/repo appspec-container:/project-name
From here, you can either get INTO that container to execute command, or appending

$ docker exec -it appspec-container [your_command]
Get into the container with bash shell open:

$ docker exec -it appspec-container /bin/bash
Now you're inside the container, navigate to your project that contains the Gemfile.

cd path/to/your/workspace/repo
Install your required gem:

$ bundle install
Run your specs:

$ bundle exec rspec spec/your-specs
NOTE: if your test suites has command to run with adb somewhere (e.g: adb install, adb uninstall...), make sure you have specify with -s $ANDROID_DEVICES to route the command to the specific emulator you want.

This project is maintained and funded by Nimbl3 Ltd.

We love open source and do our part in sharing our work with the community! See our other projects or hire our team to help build your product.