Настройка типов сборки в Android Studio: пошаговое руководство

Введение / Зачем это нужно

Типы сборки (debug, release и другие) определяют набор настроек, которые Gradle применяет при компоновке проекта. Правильная конфигурация позволяет быстро переключаться между отладочной версией с подробным логированием и продакшн-сборкой, оптимизированной для производительности. После настройки вы сможете управлять такими параметрами, как режим отладки, минимизация кода, подписывающий сертификат и даже суффикс пакета для отладочных сборок.

Требования / Подготовка

• Android Studio >= 2023.2.1
• Gradle >= 8.2
• Android SDK Platform 34 (или более новая)
• Проект с модулем app (обычный проект с одним модулем)

Все действия выполняются напрямую в корневом build.gradle.kts (или build.gradle) модуля.

Пошаговая инструкция

Шаг 1: Откройте проект в Android Studio

Откройте Android проект в Android Studio. Выберите корневой каталог модуля app в панели проекта (по умолчанию он отображается слева).

Шаг 2: Найдите блок buildTypes в Gradle-файле

Откройте файл app/build.gradle.kts (или build.gradle) и найдите секцию buildTypes. Если она отсутствует, добавьте её следующим образом:

android {
    buildTypes {
        // existing types (debug, release) here
    }
}

Шаг 3: Настройте тип сборки debug

В блоке debug установите нужные параметры, например:

debug {
    isDebuggable = true
    isMinifyEnabled = false
    applicationIdSuffix = ".debug"
    // дополнительные настройки, например `proguardFiles`
}

Изменения сразу доступны для сборки.

Шаг 4: Настройте тип сборки release

Для типа release обычно включают минификацию и настраивают подписывающий сертификат:

release {
    isDebuggable = false
    isMinifyEnabled = true
    proguardFiles(
        getDefaultProguardFile("proguard-android-optimize.txt"),
        "proguard-rules.pro"
    )
    signingConfig = signingConfigs.getByName("debug") // пример; замените на реальный сертификат
}

Шаг 5: Выполните сборку и проверьте результат

Выполните Gradle Sync (File > Sync Project with Gradle Files), затем соберите проект (Build > Build Project). Готовые APK находятся в каталоге:

app/build/outputs/apk/debug/app-debug.apk
app/build/outputs/apk/release/app-release.apk

Проверьте, что отладочная сборка имеет суффикс .debug в имени пакета, а релизная сборка скомпилирована с включенной минификацией.

Проверка результата

• Отладочная сборка: запустите её на эмуляторе или устройстве — в логах должен отображаться тег DEBUG. Проверьте AndroidManifest.xml на наличие суффикса .debug.
• Релизная сборка: убедитесь, что флаг isDebuggable равен false, а isMinifyEnabled равен true. Проверьте размер APK — он должен быть меньше, чем у отладочной сборки.

Возможные проблемы

• Изменения не применяются: выполните Gradle Sync (File > Sync Project with Gradle Files) или Build > Clean Project > Build.
• Сборка завершается с ошибкой из-за отсутствия signingConfig: укажите корректный сертификат в блоке signingConfigs или используйте debug для тестирования.
• Ресурсы не обновляются: удалите кэш app/build/intermediates/annotated-classes или выполните полное перестроение проекта (Build > Rebuild Project).

Эти шаги помогут вам настроить типы сборки быстро и без ошибок. Удачной разработки!