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

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

Подпись APK — обязательный этап перед публикацией приложения в Google Play. Подписанный бинарный файл подтверждает авторство и гарантирует целостность программы. В этом гайде мы покажем, как быстро настроить подписывающий конфигурационный файл в Android Studio и получить готовый signed APK без лишних действий.

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

Android Studio версии 2023.2 или выше.
Установленный Android SDK с платформой 33 (или более новой).
Учетная запись разработчика Google Play.
ОС: Windows, macOS или Linux.

Шаг 1: Откройте мастер генерации подписанного APK

Запустите Android Studio и откройте проект.
Перейдите в меню Build → Generate Signed Bundle / APK.
В мастере выберите APK, затем нажмите Next.

Шаг 2: Выберите или создайте подписывающий конфигурационный файл

Если у вас уже есть keystore, нажмите Existing keystore и укажите его путь.
Для нового keystore выберите Create new — мастер попросит сохранить .keystore файл.

Шаг 3: Настройте параметры keystore

Заполните поля:

Поле	Что указать
Keystore path	Путь к файлу `mykeystore.keystore`
Password	Надёжный пароль (минимум 8 символов)
Alias	Имя ключа, например `mykey`
Key password	Пароль для самого ключа (может совпадать)
Valid from / Valid until	Срок действия (обычно 1 год)

Если keystore ещё не существует, используйте keytool в терминале:

keytool -genkey -v -keystore mykeystore.keystore \
  -alias mykey -keyalg RSA -keysize 2048 -validity 10000

Система запросит пароль для keystore и ключа.

Шаг 4: Соберите проект с новой подписью

После сохранения keystore вернитесь в проект. В файле app/build.gradle (модуль уровня app) убедитесь, что блок signingConfigs содержит правильные параметры:

signingConfigs {
    release {
        keyAlias 'mykey'
        keyPassword 'your_key_password'
        storeFile file('../mykeystore.keystore')
        storePassword 'your_keystore_password'
    }
}

Примените конфигурацию к сборке:

android {
    defaultConfig {
        ...
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
        }
    }
}

Теперь собрайте APK: Build → Build Bundle(s) / APK(s) → Build APK.

Шаг 5: Проверьте подписанный APK

Скопируйте сгенерированный app-release.apk на устройство (по USB или через Dropbox).
На устройстве разрешите установку из неизвестных источников (Настройки → Безопасность → Установки из неизвестных источников).
Установите APK. В меню Настройки → Приложения → Установленные приложения → Подробно вы увидите данные о подписи (subjectDN, issuerDN).

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

В информации о приложении отображаются корректные subject и issuer сертификатов.
При запуске APK система не выдает предупреждений о поврежденном или неподписанном приложении.
В build/outputs/apk/release/ присутствует файл app-release.apk с размером, соответствующим релизной сборке.

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

Ошибка «Keystore file not found or password incorrect» – проверьте путь и пароль. Убедитесь, что файл .keystore не перемещен.
APK не устанавливается – убедитесь, что на устройстве включена отладка по USB и разрешена установка из неизвестных источников.
Неправильный keyAlias в build.gradle – укажите точный алиас, указанный при создании keystore (keytool -list -keystore mykeystore.keystore).
Срок действия сертификата истёк – создайте новый keystore с validity ≥ 365 дней.

После выполнения этих шагов ваше Android-приложение будет готово к публикации в Google Play с корректной подписью. Удачной разработки!

Часто задаваемые вопросы

Как создать новый подписывающий конфигурационный файл в Android Studio?

Можно ли повторно использовать существующий keystore?

Что делать, если подписанный APK не устанавливается на устройство?

Как изменить пароль для keystore с помощью keytool?

Полезное

Откройте мастер генерации подписанного APK

Выберите или создайте подписывающий конфигурационный файл

Настройте параметры keystore

Соберите проект с новой подписью

Проверьте подписанный APK