Закрытое тестирование Google Play для приложений на Kotlin и Jetpack Compose

Новые приложения обязаны использовать подписание в Google Play: ключ подписи приложения хранит Google, а каждую загрузку вы подписываете ключом загрузки. Мастер Android Studio умеет создавать хранилище ключей и рекомендует срок действия не меньше 25 лет.

Чтобы подписывать из командной строки или в CI, храните учётные данные в файле keystore.properties вне системы контроля версий и читайте его в app/build.gradle.kts:

storePassword=myStorePassword
keyPassword=myKeyPassword
keyAlias=upload
storeFile=/path/to/upload-keystore.jks

import java.io.FileInputStream
import java.util.Properties

val keystoreProperties = Properties().apply {
    load(FileInputStream(rootProject.file("keystore.properties")))
}

android {
    signingConfigs {
        create("release") {
            keyAlias = keystoreProperties["keyAlias"] as String
            keyPassword = keystoreProperties["keyPassword"] as String
            storeFile = file(keystoreProperties["storeFile"] as String)
            storePassword = keystoreProperties["storePassword"] as String
        }
    }
    buildTypes {
        release {
            isMinifyEnabled = true
            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
            signingConfig = signingConfigs.getByName("release")
        }
    }
}

Сделайте резервную копию хранилища и обоих паролей. Если ключ загрузки потерян или утёк, создайте новый и запросите сброс ключа загрузки в Play Console; ключ подписи приложения остаётся прежним.

versionCode должен быть больше, чем у любого загруженного бандла в любом треке; versionName видят пользователи. Оба значения находятся в defaultConfig, рядом с уровнями SDK:

android {
    compileSdk = 36
    defaultConfig {
        applicationId = "com.yourcompany.app"
        targetSdk = 36
        versionCode = 2
        versionName = "1.0.1"
    }
}

С 31 августа 2026 года новые приложения и обновления должны быть нацелены на Android 16 (уровень API 36). Повышение targetSdk включает новое поведение платформы. Приложения, нацеленные на Android 15 и выше, отображаются от края до края, а в Android 16 отключить это уже нельзя, поэтому до начала теста проверьте, что экраны Compose правильно обрабатывают window insets.

• R8 удаляет то, что нужно рефлексии. С isMinifyEnabled = true модели сериализации, классы Retrofit или Gson и некоторые схемы внедрения зависимостей могут ломаться только в release. Добавьте правила в proguard-rules.pro и проверьте вариант release.
• Сюрпризы режима от края до края. Контент под строкой состояния и панелью навигации закрывает кнопки. Используйте отступы Scaffold или модификаторы WindowInsets на каждом экране, который увидят тестировщики.
• Отлаживаемый release. Если в типе сборки release стоит isDebuggable = true, Play Console отклонит бандл.
• Секреты подписи в git. Пароли, записанные прямо в build.gradle.kts, оказываются в репозитории. Храните их в keystore.properties или в секретах CI.
• Нативные библиотеки и страницы 16 КБ. Приложения только на Kotlin уже поддерживают страницы памяти 16 КБ, но код NDK и библиотеки с файлами .so нужно пересобрать или обновить. Play Console предупреждает об этом, а с 1 февраля 2027 года обновления без такой поддержки нельзя будет выпустить.
• Проверка только debug. Тестировщики получают вариант release. Перед каждой загрузкой запускайте его хотя бы на одной свежей версии Android.

Тестировщики запускают только релизный вариант, поэтому их сбои приходят из оптимизированного R8 кода с переименованными классами и методами. Сборка записывает сопоставление, которое отменяет это, в app/build/outputs/mapping/release/mapping.txt, перезаписывает его при каждой сборке и также кладёт в .aab.

1. 1

   Доверьте деобфускацию Play Console

   Начиная с Android Gradle plugin 4.1, Play Console берёт файл сопоставления из загруженного бандла. Сбои в разделе Мониторинг и улучшение → Android Vitals → Сбои и ANR тогда показывают настоящие имена классов и методов.

2. 2

   Храните копию для каждого выпуска

   Архивируйте mapping.txt с каждым загруженным кодом версии. Он понадобится для трассировок, которые тестировщики вставляют в отчёты, и для любых инструментов сбоев вне Google Play.

3. 3

   Восстанавливайте трассировку вручную

   Запустите retrace из набора command-line tools с файлом сопоставления и файлом трассировки. Последние версии Android Studio также автоматически восстанавливают трассировки в Logcat.

$ANDROID_HOME/cmdline-tools/latest/bin/retrace \
  app/build/outputs/mapping/release/mapping.txt trace.txt

Используете NDK? Задайте debugSymbolLevel в релизном типе сборки. SYMBOL_TABLE даёт имена функций в Play Console, FULL добавляет файлы и номера строк. В app bundle нативные символы включаются и загружаются автоматически.

android {
    buildTypes {
        release {
            ndk {
                debugSymbolLevel = "FULL" // or "SYMBOL_TABLE"
            }
        }
    }
}

Если R8 оставляет неожиданный код или удаляет код, нужный для рефлексии, -whyareyoukeeping показывает путь от сохранённого класса до точки входа, а configuration.txt рядом с сопоставлением перечисляет все объединённые правила.

Когда бандл Kotlin / Jetpack Compose собран и подписан, всё остальное происходит в Play Console и одинаково для любого фреймворка. Здесь краткий чек-лист; каждое меню и экран описаны в полном руководстве по Play Console.

• Завершите настройку приложения на панели управления: политика конфиденциальности, доступ к приложению, реклама, возрастной рейтинг, целевая аудитория, безопасность данных и страница в Play Маркете.
• Создайте выпуск для закрытого теста в разделе Тестирование и выпуск → Тестирование → Закрытое тестирование: выберите страны тестировщиков, загрузите .aab и отправьте на проверку.
• Добавьте тестировщиков через Google Группу на вкладке Тестировщики и поделитесь ссылкой opt-in. Она заработает, когда у трека появится статус Опубликовано.
• Держите не менее 12 тестировщиков с opt-in 14 дней подряд. Внутреннее тестирование не засчитывается, а у того, кто вышел и вернулся, отсчёт 14 дней начинается заново.
• Выпустите хотя бы одно обновление во время теста и запишите, что нашли тестировщики и что вы изменили.
• Подайте заявку на доступ к продакшену с панели управления и ответьте на три раздела о тесте, приложении и готовности. Решение принимает Google; никто не может гарантировать одобрение.

Учитывайте выбывших: наберите больше 12 тестировщиков, чтобы уход одного человека не сдвинул ваши сроки. Все шаги в Play Console.

Увеличьте versionCode, пересоберите бандл (Gradle или мастер Android Studio) и загрузите его в тот же закрытый трек.

./gradlew bundleRelease

Чтобы установить бандл, который вы собираетесь загрузить, сгенерируйте из него APK для конкретного устройства с помощью bundletool, подписав ключом загрузки. Это ближе всего к тому, что доставляет Google Play, включая разделение по плотности экрана, языку и ABI:

bundletool build-apks --connected-device \
  --bundle=app/build/outputs/bundle/release/app-release.aab --output=app.apks \
  --ks=/path/to/upload-keystore.jks --ks-key-alias=upload
bundletool install-apks --apks=app.apks

Для быстрых проверок вашей командой внутренний обмен приложениями в Play Console принимает любой код версии и даёт ссылку на скачивание для 100 человек максимум. Такие загрузки не могут входить в тестовый трек и не заменяют закрытый тест: ваши 12 тестировщиков всегда устанавливают приложение из закрытого трека.