There are three variants of the image, all based on bellsoft/liberica-openjdk-alpine:

• JDK8 images are based on Liberica JDK 8u422-6 and uses the tag's suffix -jdk8.
• JDK11 images are based on Liberica JDK 11.0.24-9 and uses the tag's suffix -jdk11.
• JDK17 images are based on Liberica JDK 17.0.12-10 and uses the tag's suffix -jdk17.
• JDK21 images are based on Liberica JDK 21.0.4+9 and uses the tag's suffix -jdk21.

Since January 1st 2021, new versions now include the date it was published so is possible to revert to a previous version. The versioning only applies to tags with the JDK version specified. The tag's format is: android-XX-jdkZZ-vYYYY.MM.DD, where:

• XX is the API level.
• ZZ is the version of the JDK.
• YYYY is the year of the release version.
• MM is the month of the year of the release version with leading zeros.
• DD is the day of the month of the release version with leading zeros.

A valid example would be android-30-jdk11-v2021.01.01. Here are listed all the versions.

📝 Versioning is not available for alpine-android-base.

RUN sdkmanager <list-of-packages>

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

Because of the DockerHub rate limits, the image is now in three different containers registries:

• DockerHub: Base Image and Android Image.
• GitHub Container Registry: Base Image and Android Image.
• Quay: Base Image and Android Image.

Replace <tag> with one of the current available tags.

You can pull a specific Docker image from DockerHub with the following command:

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

docker pull alvrme/alpine-android:<tag>

You can pull a specific Docker image from GitHub Container Registry with the following command:

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

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

You can pull a specific Docker image from Quay with the following command:

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

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

Replace <tag> with one of the current available tags.

You can use the Docker images from DockerHub as a base image for creating a new one:

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

FROM alvrme/alpine-android:<tag>

You can use the Docker images from GitHub Container Registry as a base image for creating a new one:

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

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

You can use the Docker images from Quay as a base image for creating a new one:

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

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

Replace <tag> with one of the current available tags.

The command below will create a new container based on the specific image. It will open in the /home/android directory and the various available commands in the PATH will be able to be executed. Once the container is closed, it will be deleted. To keep the container after closing it, you have to remove --rm from the command.

Run the container from the DockerHub image:

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

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

Run the container from the GitHub Container Registry image:

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

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

Run the container from the Quay image:

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

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

The base image also includes the extras command that contains small utilities that are not installed by default, since their use is not widespread.

These extras are executed with the command extras <command> and are the following

fastlane is a tool for iOS and Android developers to automate tedious tasks like generating screenshots, dealing with provisioning profiles, and releasing your application. Visit their documentation for more information.

This command allows you to install fastlane. There are two variants:

extras fastlane

This command allows you to install the latest version of fastlane. If you want to use a specific version, the command is as follows:

extras fastlane <version>

The Android NDK is a toolset that lets you implement parts of your app in native code, using languages such as C and C++. For certain types of apps, this can help you reuse code libraries written in those languages.

This command allows you to install NDK and CMAKE using the latest versions available (NDK: 26.1.10909125; CMAKE: 3.22.1):

extras ndk

Is also possible to specify the version of NDK and CMAKE with:

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

It is not necessary to enter both versions, is possible to omit one.

Read more here

The main difference between Alpine Android and Alpine Android Base is that the first one includes the corresponding build-tools and platforms;android versions. All Alpine Android versions share 95% of the code. Using a base image with the common part makes it easier to maintain.