🥇Изграждане на Android проект в Docker контейнер

Когато разработвате проект за Android, дори и най-малкият, рано или късно се сблъсквате с разработващата среда. Освен Android SDK е необходимо да имате последната версия на Kotlin, Gradle, platform-tools и build-tools. И ако на машината на разработчика тези зависимости се решават предимно чрез Android Studio IDE, то на CI/CD сървъра всяка актуализация може да се превърне в головоболие. И ако за уеб разработката решението на проблема с околната среда стана стандарт с Docker, защо да не опитаме да решим аналогичен проблем и в Android разработката...

За тези, които не знаят какво е Docker — в най-простия вид, това е инструмент за създаване на т.н. „контейнери“, в които се съдържа минималното ядро на операционната система и необходимия софтуер, които можем да разгръщаме където пожелаете, запазвайки същевременно околната среда. Какво точно ще бъде в нашия контейнер се определя в Dockerfile, който след това се компилира в образ, който може да се стартира навсякъде и притежава свойствата на идемпотентност.

Процесът на инсталиране и основите на Docker са прекрасно описани в документацията му. официалния сайтЗатова, като забягваме малко напред, ето какъв Dockerfile получихме.

# Т.к. основным инструментом для сборки Android-проектов является Gradle, 
# и по счастливому стечению обстоятельств есть официальный Docker-образ 
# мы решили за основу взять именно его с нужной нам версией Gradle
FROM gradle:5.4.1-jdk8

# Задаем переменные с локальной папкой для Android SDK и 
# версиями платформы и инструментария
ENV SDK_URL="https://dl.google.com/android/repository/sdk-tools-linux-3859397.zip" 
    ANDROID_HOME="/usr/local/android-sdk" 
    ANDROID_VERSION=28 
    ANDROID_BUILD_TOOLS_VERSION=28.0.3

# Создаем папку, скачиваем туда SDK и распаковываем архив,
# который после сборки удаляем
RUN mkdir "$ANDROID_HOME" .android 
    && cd "$ANDROID_HOME" 
    && curl -o sdk.zip $SDK_URL 
    && unzip sdk.zip 
    && rm sdk.zip 
# В следующих строчках мы создаем папку и текстовые файлы 
# с лицензиями. На оф. сайте Android написано что мы 
# можем копировать эти файлы с машин где вручную эти 
# лицензии подтвердили и что автоматически 
# их сгенерировать нельзя
    && mkdir "$ANDROID_HOME/licenses" || true 
    && echo "24333f8a63b6825ea9c5514f83c2829b004d1" > "$ANDROID_HOME/licenses/android-sdk-license" 
    && echo "84831b9409646a918e30573bab4c9c91346d8" > "$ANDROID_HOME/licenses/android-sdk-preview-license"    

# Запускаем обновление SDK и установку build-tools, platform-tools
RUN $ANDROID_HOME/tools/bin/sdkmanager --update
RUN $ANDROID_HOME/tools/bin/sdkmanager "build-tools;${ANDROID_BUILD_TOOLS_VERSION}" 
    "platforms;android-${ANDROID_VERSION}" 
    "platform-tools"

Запазваме го в папката с нашия Android проект и стартираме сборката на контейнера с командата.

docker build -t android-build:5.4-28-27 .

Параметър -t определя таг или името на нашия контейнер, което обикновено се състои от името му и версията. В нашия случай го нарекохме android-build, а в версията посочихме съвкупността от версиите на gradle, android-sdk и platform-tools. По-късно ще ни бъде по-лесно да търсим нужния образ по име, използвайки такава „версия“.

След като сборката е завършена, можем да използваме нашия образ локално, можем да го качим с команда. docker push в публичен или частен репозиторий на образи, за да можем да го изтеглим на други машини.

В качеството на пример ще съберем проекта локално. За целта в папката с проекта изпълняваме командата.

docker run --rm -v "$PWD":/home/gradle/ -w /home/gradle android-build:5.4.1-28-27 gradle assembleDebug

Да разгледаме какво означава тя:

docker run — самата команда за стартиране на образа.
-rm — означава, че след спирането на контейнера, той изтрива всичко, което е създадено в процеса на живота му.
-v "$PWD":/home/gradle/ — монтира текущата папка с нашия Android проект във вътрешната папка на контейнера /home/gradle/
-w /home/gradle — задава работната директория на контейнера.
android-build:5.4.1-28-27 — името на нашия контейнер, който създадохме.
gradle assembleDebug — екипът, който събира нашия проект

Ако всичко върви успешно, след няколко секунди/минуты на екрана ви ще видите нещо като BUILD SUCCESSFUL in 8m 3s! В папката app/build/output/apk ще бъде събраното приложение.

По подобен начин могат да се изпълняват и други задачи на gradle — проверка на проекта, стартиране на тестове и т.н. Основното предимство е, че при необходимост от изграждане на проекта на друга машина, не трябва да се притесняваме за инсталиране на цялата среда, а е достатъчно да изтеглим необходимия образ и да стартираме изграждането.

Контейнерът не съхранява никакви промени и всяко изграждане стартира от нула, което от една страна гарантира идентичността на сглобяването независимо от мястото на стартиране, а от друга страна всеки път се налага да изтегляме всичките зависимости и компилираме целия код отново, което понякога може да отнеме значително време. Затова, освен обикновения „студен“ старт, имаме опция за стартиране на изграждането с запазване на т.н. „кеш“, където запазваме папката ~/ .gradle, просто я копирайки в работната папка на проекта, а в началото на следващото изграждане я връщаме обратно. Всички процедури по копиране сме изнесли в отделни скриптове и самата команда за стартиране стана такава

docker run --rm -v "$PWD":/home/gradle/ -w /home/gradle android-build:5.4.1-28-27 /bin/bash -c "./pre.sh; gradle assembleDebug; ./post.sh"

В крайна сметка, средното време за изграждане на проекта ни значително се съкрати (в зависимост от броя на зависимостите, но средният проект сега се изгражда за 1 минута вместо 5 минути).

Всичко това разбира се има смисъл само ако разполагате с вътрешен CI/CD сървър, за поддръжката на който сами се грижите. Но сега има много облачни услуги, в които всички тези проблеми са решени и не е нужно да се тревожите за това, а необходимите свойства за изграждане могат да се зададат и в настройките на проекта.

Само регистрирани потребители могат да участват в анкетата. Влезте, моля.