An optimized Docker image that includes the Android SDK.

It includes the following components:

• Debian 11
• Java (OpenJDK)
  • 11
• Android SDKs for platforms:
  • 33
• Android build tools:
  • 33.0.0
• cmake
• Python (2.7.18)
• Ruby (2.7.4), RubyGems (3.2.5)
• fastlane (2.211.0)
• jenv

The docker image is a publicly automated build on Docker Hub based on the Dockerfile in this repo, so there is no hidden stuff in it. To pull the latest docker image:

docker pull matheussouza/docker-android-build-tools

Hint: You can use a tag to a specific stable version, rather than latest of docker image, to avoid breaking your build. e.g. matheussouza/docker-android-build-tools:v1.0.0. Take a look at the Releases section, to see all the available releases.

You can use this docker image to build your Android project with a single docker command:

cd <android project directory>  # change working directory to your project root directory.
docker run --rm -v $(pwd):/app matheussouza/docker-android-build-tools bash -c 'cd /app; ./gradlew build'

To build .aab bundle release, use ./gradlew bundleRelease:

cd <android project directory>  # change working directory to your project root directory.
docker run --rm -v $(pwd):/app matheussouza/docker-android-build-tools bash -c 'cd /app; ./gradlew bundleRelease'

Run docker image with interactive bash shell:

docker run -it -v $(pwd):/app matheussouza/docker-android-build-tools /bin/bash

Add the following arguments to the docker command to cache the home gradle folder:

-v "$HOME/.dockercache/gradle":"/root/.gradle"

e.g.

docker run --rm -v $(pwd):/app  -v "$HOME/.dockercache/gradle":"/root/.gradle" matheussouza/docker-android-build-tools bash -c 'cd /project; ./gradlew build'

If you have an Android project in a Bitbucket repository and want to use the pipeline feature to build it, you can simply specify this docker image. Here is an example of bitbucket-pipelines.yml:

image: matheussouza/docker-android-build-tools:latest

pipelines:
  default:
    - step:
        caches:
          - gradle
          - gradle-wrapper
          - android-emulator
        script:
          - bash ./gradlew assemble
definitions:
  caches:
    gradle-wrapper: ~/.gradle/wrapper
    android-emulator: $ANDROID_HOME/system-images/android-21

The caches are used to store downloaded dependencies from previous builds, to speed up the next builds.

Java 11 is installed.

If versions other than those listed are needed, just change the respective ENVs in Docerfile and build the image.

If you want to build the docker image by yourself, you can use following command. The image itself is around 1.3 GB, so check your free disk space before building it.

docker build -t docker-android-build-tools .

If you want to enhance this docker image or fix something, feel free to send pull request.

• Dockerfile reference
• Best practices for writing Dockerfiles
• Build your own image
• uber android build environment
• Docker Android Build Box
• Refactoring a Dockerfile for image size
• Label Schema