Alpine Android

For tags that specify a JDK version, you can use date-based versioning to revert to a specific release. The tag format is:

android-{API_LEVEL}-{JDK_VERSION}-v{YYYY.MM.DD}

Example: android-30-jdk11-v2021.01.01

Note: Versioning is not available for alpine-android-base images.

The two image variants differ by the inclusion of build tools:

• Alpine Android: Includes build-tools and platforms;android versions.
• Alpine Android Base: Contains only the common core (95% shared with the full image). Use this as a base for custom images to simplify maintenance.

Run a new container interactively. The container will open in the /home/android directory, and all included tools will be available in the PATH.

Note: Using the --rm flag will delete the container once it is closed. To persist the container after closing, remove the --rm flag.

DockerHub

docker run --rm -it alvrme/alpine-android-base:<tag>

GHCR

docker run --rm -it ghcr.io/alvr/alpine-android-base:<tag>

Quay

docker run --rm -it quay.io/alvr/alpine-android-base:<tag>

docker run --rm -it alvrme/alpine-android:<tag>

To create a custom image, use the Alpine Android images in your FROM instruction. Replace <tag> with a valid version tag.

DockerHub

FROM alvrme/alpine-android-base:<tag>
FROM alvrme/alpine-android:<tag>

GHCR

FROM ghcr.io/alvr/alpine-android-base:<tag>
FROM ghcr.io/alvr/alpine-android:<tag>

Quay

FROM quay.io/alvr/alpine-android-base:<tag>
FROM quay.io/alvr/alpine-android:<tag>

Alpine Android images are based on bellsoft/liberica-runtime-container using Alpaquita Linux (glibc). Choose your JDK variant based on the Android Gradle Plugin (AGP) version you are using:

You can use the Alpine Android Docker images as a base for your own Dockerfiles. Once you have set the base image, you can install additional Android or Alpine packages directly within your Dockerfile.

To install Android packages, use the sdkmanager command:

RUN sdkmanager <list-of-packages>

To install Alpine packages, use the apk package manager:

RUN apk add --no-cache <list-of-packages>

You can pull the alpine-android-base or alpine-android images from three different registries. Replace <tag> with a valid version tag.

DockerHub

Use the alvrme/ prefix.

GitHub Container Registry (GHCR)

Use the ghcr.io/alvr/ prefix.

Quay

Use the quay.io/alvr/ prefix.

# DockerHub
docker pull alvrme/alpine-android-base:<tag>
docker pull alvrme/alpine-android:<tag>

# GHCR
docker pull ghcr.io/alvr/alpine-android-base:<tag>
docker pull ghcr.io/alvr/alpine-android:<tag>

# Quay
docker pull quay.io/alvr/alpine-android-base:<tag>
docker pull quay.io/alvr/alpine-android:<tag>

The following table lists the common Android SDK components and their locations across various Android version images. Note that specific versions of build-tools and platforms will vary depending on the specific Android version image you are using.

| Path | Version | Description | Location |
|---|---|---|---|
| build-tools;[version] | [version] | Android SDK Build-Tools | build-tools/[version]/ |
| extras;google;instantapps | 1.9.0 | Google Play Instant Development SDK | extras/google/instantapps/ |
| patcher;v4 | 1 | SDK Patch Applier v4 | patcher/v4/ |
| platform-tools | 37.0.0 | Android SDK Platform-Tools | platform-tools/ |
| platforms;android-[api] | [version] | Android SDK Platform [api] | platforms/android-[api]/ |

The alpine-android-base image contains the following components:

The base image includes an extras command to install optional utilities that are not included by default. These are executed using the syntax extras <command>.

Install Fastlane

Fastlane automates iOS and Android tasks like screenshots and provisioning.

• To install the latest version: extras fastlane
• To install a specific version: extras fastlane <version>

Install NDK and CMAKE

To implement native code (C/C++), use the extras ndk command. By default, this installs the latest available versions (e.g., NDK 29.0.14206865 and CMAKE 4.1.2).

To specify custom versions, use the following flags:

• --ndk | -n <version>
• --cmake | -c <version>

extras fastlane <version>
extras ndk [--ndk | -n <version>] [--cmake | -c <version>]