Настройка автоматической сборки Android-приложения (Build Automation)
Мы часто видим, как разработчики жалуются на долгую сборку в CI: проект с 15+ модулями, Gradle работает на одном потоке, холодная сборка 4–7 минут, инкрементальная — 90 секунд. В команде из 10 человек это превращается в очередь билдов, блокирующую ревью. Наш опыт показывает, что правильная автоматизация сборки — не панацея, а системная работа с конфигами Gradle, CI-пайплайном и кэшированием. Настраиваем всё так, чтобы билд проходил на любой машине стабильно и без ручных шагов.
Основные точки боли при Android Build Automation
Как безопасно подписывать APK/AAB в CI?
Самая частая проблема. Разработчики хранят keystore в репозитории (плохо) или передают через аргументы командной строки открытым текстом (ещё хуже). Правильная схема: keystore кодируется в Base64, кладётся в переменную окружения CI, перед сборкой декодируется во временный файл, после сборки — удаляется. В build.gradle.kts это конфигурируется через переменные окружения:
android { signingConfigs { create("release") { storeFile = file(System.getenv("KEYSTORE_PATH") ?: "debug.keystore") storePassword = System.getenv("KEYSTORE_PASSWORD") ?: "android" keyAlias = System.getenv("KEY_ALIAS") ?: "androiddebugkey" keyPassword = System.getenv("KEY_PASSWORD") ?: "android" } } buildTypes { release { signingConfig = signingConfigs.getByName("release") isMinifyEnabled = true proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro") } } } Конфигурация сборки по веткам
Второй болевой узел. main → release AAB для Play Store, develop → debug APK с тестовыми эндпоинтами, release/* → staging APK для QA. Реализуется через комбинацию buildFlavors + условия в CI-скрипте. Не нужно плодить отдельные build.gradle файлы — достаточно одной конфигурации с flavorDimensions.
Почему важно кэширование Gradle?
Без кэша CI качает 200–400 МБ зависимостей при каждом запуске. С правильным кэшированием ~/.gradle/caches и ~/.gradle/wrapper первая сборка после изменения build.gradle занимает полное время, остальные — инкрементально. В среднем экономия ~60% времени сборки после первого билда. Мы используем remote build cache (через S3) для распределённых команд.
Как настраиваем
Базовый стек: Gradle 8.x + AGP 8.x + GitHub Actions / GitLab CI / Bitrise. Fastlane используем для задач, которые Gradle не умеет из коробки: загрузка в Google Play через supply, отправка уведомлений, управление треками (internal → alpha → production).
Структура типичного CI-пайплайна (GitHub Actions):
# .github/workflows/android-release.yml jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-java@v4 with: java-version: '17' distribution: 'temurin' - name: Cache Gradle uses: actions/cache@v4 with: path: | ~/.gradle/caches ~/.gradle/wrapper key: gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }} - name: Decode Keystore run: echo "$KEYSTORE_BASE64" | base64 -d > app/release.keystore env: KEYSTORE_BASE64: ${{ secrets.KEYSTORE_BASE64 }} - name: Build Release AAB run: ./gradlew bundleRelease env: KEYSTORE_PATH: release.keystore KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }} KEY_ALIAS: ${{ secrets.KEY_ALIAS }} KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }} - name: Upload Artifact uses: actions/upload-artifact@v4 with: name: release-aab path: app/build/outputs/bundle/release/app-release.aab Отдельно настраиваем gradle.properties под CI: org.gradle.daemon=false (демон в CI не нужен), org.gradle.parallel=true, org.gradle.configureondemand=true. На проектах с несколькими модулями это сокращает время конфигурации на 30–40%.
Параллельные задачи и оптимизация
Если проект монолитный, параллелизация почти не даёт эффекта. Но при модульной архитектуре (:core, :feature-auth, :feature-feed, :app) Gradle строит граф зависимостей и собирает независимые модули параллельно. ./gradlew assembleDebug --parallel на 8-ядерном агенте даёт выигрыш в 2–3 раза по сравнению с последовательной сборкой.
Для больших команд подключаем Gradle Build Cache — либо через Gradle Enterprise (платно), либо через открытое решение с S3 бэкендом.
| Тип сборки | Без оптимизации | С оптимизацией (кэш + параллель) |
|---|---|---|
| Холодная (все модули) | 5–7 мин | 2–3 мин |
| Инкрементальная | 90 сек | 20–30 сек |
Gradle User Manual рекомендует комбинировать оба подхода.
Сравнение CI-платформ для Android
| CI Платформа | Особенности настройки | Среднее время сборки после кэша |
|---|---|---|
| GitHub Actions | Простая интеграция, большая экосистема | ~2 мин |
| GitLab CI | Встроенный Docker, отличный кэш | ~1.5 мин |
| Bitrise | Оптимизирован для мобильных, много готовых шагов | ~2.5 мин |
Частые ошибки при настройке CI
- Неправильное кодирование keystore (Base64 с переносом строк) приводит к ошибке декодирования.
- Отсутствие кэша между запусками: если не использовать
actions/cacheс правильным ключом, каждый билд загружает зависимости заново. - Использование debug-подписи в релизном AAB — Google Play отклонит такой файл.
- Забывают отключать Gradle Daemon в CI, что ведёт к нестабильности.
Что входит в работу
- Аудит текущего
build.gradle(Groovy → Kotlin DSL, версии плагинов, неоптимальные конфиги) - Настройка signing config через переменные окружения CI
- CI-пайплайн под вашу платформу (GitHub Actions, GitLab CI, Bitrise)
- Кэширование Gradle (локальное и remote)
- Конфигурация по веткам с помощью build flavors
- Документация для команды и обучение разработчиков
- Гарантия стабильности — после сдачи всё работает без ручных донастроек
Процесс работы
- Первичная консультация и анализ текущей сборки.
- Перевод на современный Gradle + Kotlin DSL (если необходимо).
- Настройка signing config через секреты CI.
- Создание CI-конфигурации с кэшированием и параллельностью.
- Тестирование на нескольких ветках (main, develop, release/).
- Документирование и передача команде.
Стоимость рассчитывается индивидуально после анализа требований. Срок: 2–3 дня для одномодульного проекта, до 5 дней для многомодульного. Свяжитесь с нами для оценки вашего проекта — поможем внедрить build automation под ключ. Закажите консультацию, чтобы узнать точные сроки для вашего проекта.
Мы имеем более 5 лет опыта в Android-разработке и настроили пайплайны для 30+ проектов — от стартапов до enterprise-приложений. Наши инженеры следят за актуальными версиями Gradle и AGP, поэтому вы получаете современную конфигурацию без устаревших практик.







