В Android Studio процесс сборки автоматизирован с помощью системы Gradle, но Вам нужно правильно выбрать тип сборки и подписать её цифровым ключом.
Два типа сборок: Debug и Release
Прежде чем нажать кнопку «Сохранить», важно понимать разницу между двумя режимами:
- Debug (Отладочная сборка)
- Создается автоматически, когда Вы нажимаете на зеленый треугольник «Run».
- Содержит инструменты для отладки.
- Не подходит для публикации. Google Play и системы безопасности телефона могут блокировать установку таких файлов, если они скачаны не из IDE.
- Release (Релизная сборка)
- Оптимизирован по размеру и скорости.
- Обязательно должен быть подписан цифровым ключом.
- Это именно тот файл, который нужен для публикации.
Шаг 1: Подготовка (Подписание приложения)
Android требует, чтобы каждое приложение было «подписано» автором. Это гарантирует, что обновления выпускает именно создатель, а не злоумышленник.
Вариант А: Подписывание через Android Studio Wizard (Рекомендуется)
Это самый простой способ. Android Studio сам создаст ключ и настроит проект.
- В верхнем меню выберите Build > Generate Signed App / Bundle.
- В появившемся окне выберите APK и нажмите «Next».
- В разделе «Key store path» нажмите на кнопку с плюсом «Create new».
- Заполните форму создания хранилища ключей (Key store):
- Key store path: Выберите папку на компьютере, где будет лежать файл ключа (например, в корне проекта, но ни в коем случае не добавляйте его в Git). Имя файла, например, "my_upload_key.jks".
- Password: Придумайте сложный пароль для самого файла хранилища.
- Alias: Имя ключа (например, "upload_key"). Это псевдоним внутри хранилища.
- Password: Пароль для самого ключа (можно сделать таким же, как у хранилища).
- Validity (years): Срок действия. Поставьте 25 лет или больше (например, 100). Если ключ истечет, Вы не сможете обновлять приложение в Google Play.
- Заполните свои данные (First and Last Name и т.д.).
- Нажмите «OK». Android Studio вернет Вас в предыдущее окно, где теперь выбран Ваш новый ключ. Введите пароли, которые только что создали.
Вариант Б: Ручная настройка (Для опытных)
Если Вы создали ключ вручную через терминал, Вам нужно создать файл "keystore.properties" в корне папки "app/" (рядом с "build.gradle") и прописать туда пути и пароли, чтобы не хранить их в открытом коде. Но для первого раза Вариант А гораздо безопаснее и проще.
Шаг 2: Генерация файла
После того как ключ выбран и пароли введены (в Варианте А):
- Нажмите «Next».
- Build Variants: Выберите "release".
- Signature Versions: Оставьте обе галочки ("V1" и "V2"). Это обеспечит совместимость со всеми устройствами.
- Нажмите «Finish».
Внизу Android Studio откроется вкладка Build. Вы увидите лог работы Gradle. Сначала он «чистит» (clean) проект, затем собирает (assemble) его.
Важно: Не закрывайте Android Studio и не выключайте компьютер, пока не увидите зеленую надпись "BUILD SUCCESSFUL" в конце лога.
Шаг 3: Где найти готовый APK
Когда сборка завершена, Android Studio покажет уведомление в правом углу экрана: "APK(s) generated successfully".
Нажмите на ссылку "locate" (или «Показать в проводнике») в этом уведомлении.
Если ссылки нет, путь по умолчанию выглядит так: "Ваш_Проект/app/build/outputs/apk/release/".
В этой папке Вы найдете файл:
- "app-release.apk" — готовый файл для установки.
- "app-release.aab" — если Вы выбрали формат AAB (нужен для Google Play).
Проверка (Локальная установка)
Перед отправкой в магазин проверьте файл:
- Подключите реальный смартфон к компьютеру (включив «Отладку по USB»).
- Или просто перетащите файл "app-release.apk" в открытый эмулятор.
- Система спросит: «Установить приложение?». Нажмите «Да».
Если приложение запустилось и работает — поздравляю, Вы успешно собрали релизную версию.
Типичные ошибки новичков
- Забыли пароль от ключа: Android Studio не хранит пароли в проекте. Если Вы забудете пароль от "my_upload_key.jks", Вы никогда не сможете обновить свое приложение в Google Play. Придется создавать новый ключ и загружать приложение заново как новое. Храните пароли в менеджере паролей.
- Потеряли файл ".jks": То же самое. Без этого файла нельзя подписать обновление. Храните файл ключа в облаке или на внешнем носителе.
- Срок ключа 1 год: Если Вы поставили срок действия ключа 1 год, через год Google Play заблокирует возможность обновлений. Всегда ставьте 25+ лет.
Теперь Ваше приложение готово к тому, чтобы увидеть мир. Удачи с публикацией!
