Android CI tutorial for Docker and GitLab

The projects presents Android CI tutorial covering Docker and GitLab

• Android CI tutorial for Docker and GitLab
  • Docker
  • GitLab
    • Tutorials
    • References to Dockerfiles

Docker

Goal: To create a Docker image that contains the Android SDK command line tools installed in it.

• Create a account in Docker. Then go to Docker hub.

• Next, link your Github or Bitbucket account to your Docker account.

• Then, go to Github or Bitbucket to create a new repository that contains Docker file. Because, Docker currently supports only Github and Bitbucket for creating automation builds.

• After creating a repository in Github or Bitbucket. Create a new file. Name the file as

    Dockerfile
  

  without any extensions.

Here is the code for Dockerfile

#
# GitLab CI: Android
# Version: 1.0.0
#
# https://hub.docker.com/r/sakarsh/gitlab-ci-android-akarsh-seggemu/
#

FROM ubuntu:18.04
MAINTAINER Akarsh Seggemu <sakarshkumar@gmail.com>

ENV VERSION_SDK_TOOLS "3859397"

ENV ANDROID_HOME "/sdk"
ENV PATH "$PATH:${ANDROID_HOME}/tools"
ENV DEBIAN_FRONTEND noninteractive

RUN apt-get -qq update && \
    apt-get install -qqy --no-install-recommends \
      bzip2 \
      curl \
      git-core \
      html2text \
      openjdk-8-jdk \
      libc6-i386 \
      lib32stdc++6 \
      lib32gcc1 \
      lib32ncurses5 \
      lib32z1 \
      unzip \
    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

RUN rm -f /etc/ssl/certs/java/cacerts; \
    /var/lib/dpkg/info/ca-certificates-java.postinst configure

RUN curl -s https://dl.google.com/android/repository/sdk-tools-linux-${VERSION_SDK_TOOLS}.zip > /sdk.zip && \
    unzip /sdk.zip -d /sdk && \
    rm -v /sdk.zip

RUN mkdir -p $ANDROID_HOME/licenses/ \
  && echo "8933bad161af4178b1185d1a37fbf41ea5269c55\nd56f5187479451eabf01fb78af6dfcb131a6481e" > $ANDROID_HOME/licenses/android-sdk-license \
  && echo "84831b9409646a918e30573bab4c9c91346d8abd" > $ANDROID_HOME/licenses/android-sdk-preview-license

ADD packages.txt /sdk
RUN mkdir -p /root/.android && \
  touch /root/.android/repositories.cfg && \
  ${ANDROID_HOME}/tools/bin/sdkmanager --update 

RUN while read -r package; do PACKAGES="${PACKAGES}${package} "; done < /sdk/packages.txt && \
    ${ANDROID_HOME}/tools/bin/sdkmanager ${PACKAGES}

The Dockerfile code contains the following,

• The base OS image is defined in FROM

• The maintainer of the docker in MAINTAINER

• The Android SDK tools is update after evey new release. With every new update the version number in the download link is updated. Having a variable ENV VERSION_SDK_TOOLS for the version number reduces the effort in long run for maintaining the Dockerfile.

• ENV ANDROID_HOME is used for storing sdk folder name.

• ENV PATH is used for storing the android sdk tools path.

• DEBIAN_FRONTEND is used for installing the packages in Docker.

• RUN apt-get -qq update and the consecutive commands are used to update the packages and install packages.

• RUN rm -f /etc/ssl/certs/java/cacerts; is used for java ceritifcate.

• RUN curl -s https://dl.google.com/android/repository/sdk-tools-linux-${VERSION_SDK_TOOLS}.zip for downloading the Android SDK tools

• RUN mkdir -p $ANDROID_HOME/licenses/ is used for creating a directory to accept Android SDK license during installation of Android SDK Tools.

• ADD packages.txt /sdk this command adds the file packages.txt ti the sdk folder.

  • The packages.txt contains the additional packages such as Google play services to be installed.

  • Create a new file in the repository and name it as

      packages.txt
    

    and add the following code,

        add-ons;addon-google_apis-google-24
        build-tools;26.0.2
        extras;android;m2repository
        extras;google;m2repository
        extras;google;google_play_services
        extras;m2repository;com;android;support;constraint; constraint-layout;1.0.2
        extras;m2repository;com;android;support;constraint; constraint-layout-solver;1.0.2
        platform-tools
        platforms;android-26
    

• RUN mkdir -p /root/.android && is used to create a folder and the subsequent commands are used to update the Android SDK.

• RUN while read -r package; do PACKAGES="${PACKAGES}${package} is used to run the packages.txt file. Next, the packages are downloaded and installed.

• After the creating the Dockerfile and adding the mentioned code above. Next, go to Docker hub and click on create a automated build

• Select the linked Github or bitbucket account to access the Github or Bitbucket repository.

• Select the Github or Bitbucket repository.

• Add a short description for the automated build and click on create.

• Build page will be shown after completing the creation of automated build.

• Next, click on Build Settings tab and click on trigger to trigger a build job.

• When the build job is completed. Click on Build Details to see the status of the build. Success indicated the build is successfully built the docker image.

GitLab

Tutorials

• Dockerfile project

References to Dockerfiles

• dockerfiles - contains various Dockerfiles.