Мобильные приложения

Создание и выпуск Android-приложения в Google Play Market

Эта инструкция проведёт тебя через все шаги: от настройки основных параметров в vivaCRM до создания приложения в Google Play Console и подключения Firebase для пуш-уведомлений. Убедись, что у тебя уже есть зарегистрированный аккаунт разработчика в Google Play Console и проект в Firebase. Если нет — сначала прочитай нашу статью о регистрации в Google Play Console. Шаг 1. Открой настройки мобильного приложения в vivaCRM Нажми на раздел Управление в верхнем меню, чтобы перейти к настройкам системы. Шаг 1 В выпадающем меню выбери Основные настройки. Шаг 2 Нажми на вкладку Мобильное приложение. Шаг 3 Нажми на блок Сертификаты доступов и основная информация — именно с этого шага начинается подготовка к запуску релиза Android-приложения. Шаг 4 Шаг 2. Заполни основные параметры приложения Нажми на поле Название приложения и введи название своего приложения. Запомни его — оно понадобится при создании приложения в Google Play Console. Шаг 5 Поля Публичный номер версии и Внутренний код версии заполнять на этом этапе не обязательно. Настройки под iOS можно пропустить и сразу перейти к блоку Android. Найди поле Android Application ID и нажми на иконку копирования рядом с ним. Этот идентификатор понадобится при создании приложения в Google Play Console и в Firebase. Шаг 8 Один и тот же Android Application ID должен использоваться везде: в vivaCRM, при создании приложения в Google Play Console и при добавлении приложения в Firebase. После первой публикации в Google Play изменить его невозможно — если он где-то разойдётся хоть на один символ, публикация упадёт с ошибкой «denied access to this app». Шаг 3. Создай приложение в Google Play Console Перейди в Google Play Console и нажми кнопку Создать приложение. Шаг 10 В поле Название приложения введи то же название, которое ты указывал в настройках vivaCRM. Шаг 11 Нажми на поле App package name и вставь скопированный ранее Android Application ID из настроек vivaCRM. Шаг 13 Нажми на поле языка (по умолчанию стоит Английский (Соединенные Штаты) – en-US) и выбери Русский – ru-RU или другой язык, актуальный для твоего приложения. Шаг 15 Шаг 17 - Выбери тип «Приложение» (не «Игра»). Шаг 19 - Выбери «Бесплатно» — само приложение скачивается бесплатно, платные услуги внутри него при этом возможны. Шаг 20 Поставь обе галочки: согласие с правилами программы для разработчиков Google Play и с экспортным законодательством США. Шаг 24 Шаг 25 Нажми кнопку Создать приложение. Шаг 26 Шаг 4. Настрой внутреннее тестирование После создания приложения ты попадёшь в панель управления. Нажми Просмотреть задачи, чтобы развернуть список необходимых шагов. Шаг 29 Нажми Выберите тестировщиков, чтобы добавить участников внутреннего тестирования. Шаг 30 Нажми Создать список рассылки. Шаг 33 Введи любое название списка в поле Название списка, например vivaCRM Test. Шаг 34 В поле Добавьте адреса электронной почты введи e-mail и нажми Enter. Шаг 36 Используй только адреса в домене gmail.com — другие адреса Google Play не принимает. Если адрес помечен как недействительный, удали его и введи корректный gmail.com-адрес. Нажми Сохранить изменения. Шаг 38 Нажми Создать, чтобы подтвердить создание списка. Шаг 39 При необходимости добавь ещё один e-mail в поле Добавьте адреса электронной почты, нажми Enter для подтверждения. Шаг 40 Шаг 42 Нажми Сохранить изменения, затем Создать и финально Сохранить. Шаг 43 Шаг 44 Шаг 45 Пункт Выберите тестировщиков должен быть отмечен как выполненный. Шаг 47 Нажми Создайте новый выпуск, чтобы перейти к загрузке первой версии приложения. Пока что оставь эту страницу открытой — вернёшься к ней позже. Шаг 48 Шаг 5. Настрой ссылки интеграции в vivaCRM Вернись в vivaCRM → Основные настройки → Мобильное приложение → [[Сертификаты доступов и основная информация]]. Найди поле URL-схема и введи удобное название — оно будет использоваться для открытия приложения по прямым ссылкам на Android и iOS (например, embargopp://). Шаг 51 Поле Домен Universal Links (iOS) можно пропустить, если не знаешь, для чего оно нужно. Шаг 53 Шаг 6. Подключи Firebase для пуш-уведомлений Перейди на console.firebase.google.com. Выбери свой существующий проект из списка или создай новый с помощью Create a new Firebase project. Шаг 59 Внутри проекта нажми кнопку Add app и выбери платформу Android. Шаг 60 В поле Android Package Name вставь скопированный ранее Android Application ID из vivaCRM. Шаг 62 В поле App Nickname введи название своего мобильного приложения. Шаг 70 Нажми Register app. Шаг 80 На следующем шаге нажми Download google-services.json — этот файл понадобится для загрузки в vivaCRM. Шаг 81 Нажми Next, пропусти шаг с настройкой Firebase SDK и нажми Next ещё раз. Шаг 82 Шаг 84 Нажми Continue to console. Шаг 86 В Firebase перейди в Settings → General. Шаг 87 Шаг 88 Скопируй значение Project ID — оно понадобится для поля FCM Sender ID в vivaCRM. Шаг 89 Вернись в vivaCRM и вставь скопированный Project ID в поле FCM Sender ID. Шаг 93 Шаг 94 Шаг 7. Загрузи иконки и конфигурационные файлы Нажми Загрузить рядом с полем иконки приложения и выбери файл размером 1024×1024 пикселей. Шаг 99 Если ты загрузишь изображение неверного размера или формата, система покажет ошибку — просто загрузи файл в нужном формате. Сплэш-экран — это первое, что видит пользователь при открытии приложения. - Нажми Загрузить для светлой темы и выбери логотип на светлом фоне. Шаг 105 - Нажми Загрузить для тёмной темы и выбери логотип, хорошо видимый на тёмном фоне. Шаг 108 Нажми Загрузить рядом с полем google-services.json (Android) и выбери скачанный ранее из Firebase конфигурационный файл. Шаг 112 Шаг 114 Шаг 8. Получи и загрузи Service Account из Firebase В Firebase Console открой Settings → Service Accounts. Шаг 118 Нажми Generate new private key. Шаг 119 В появившемся окне подтверди, нажав Generate key — файл JSON автоматически скачается. Шаг 120 Вернись в vivaCRM. Нажми Загрузить рядом с полем Service Account (JSON, отправка push) и выбери скачанный файл. Шаг 122 Шаг 124 Шаг 9. Получи ключ сервис-аккаунта Google Play - Service Account из Firebase (Шаг 8) — нужен только для отправки push-уведомлений. - Ключ сервис-аккаунта Google Play (этот шаг) — нужен для автоматической публикации сборок в Google Play. Это разные файлы из разных мест. Ниже — про второй, публикующий. Перейди на главную страницу Google Play Console (не внутрь конкретного приложения) и нажми Настройки (Setup) в левом меню, затем — раздел API access (Доступ к API). Шаг 132 В разделе API access нажми Create new service account (Создать сервисный аккаунт). Google Play откроет ссылку на Google Cloud Console — перейди по ней, чтобы создать аккаунт на стороне Google Cloud. - В Google Cloud Console нажми Create service account (Создать сервисный аккаунт). - Задай любое имя (например, google-play-publisher) и нажми Done (Готово). В Google Cloud Console, в списке сервисных аккаунтов, открой только что созданный аккаунт → вкладка Keys (Ключи) → Add key → Create new key → тип JSON → Create. JSON-файл ключа скачается автоматически. Сохрани его — именно его ты загрузишь в vivaCRM, и из него же берётся email аккаунта для выдачи доступа. Email нужен на следующих шагах (выдача доступа). Взять его можно двумя способами: - Из JSON-файла — открой его текстовым редактором и найди поле client_email. Значение вида имя@проект.iam.gserviceaccount.com. - Из Google Cloud Console — ☰ → IAM & Admin → Service Accounts, колонка Email. Шаг 9а. Включи Google Play Android Developer API Мало создать ключ — в том же проекте Google Cloud нужно включить API, через который идёт публикация. Если этого не сделать, сборка соберётся, но шаг выгрузки в Google Play упадёт с ошибкой PERMISSION_DENIED. Перейди в console.cloud.google.com. Вверху убедись, что выбран тот же проект, в котором ты создавал сервисный аккаунт. Слева ☰ → APIs & Services → Library (APIs и сервисы → Библиотека). В поиске введи Google Play Android Developer API (в русском интерфейсе — «API для разработчиков Android в Google Play»). Открой его и нажми Enable (Включить). Если API уже включён — увидишь статус «API включён» и кнопку Управлять, дополнительно ничего делать не нужно. После включения подожди 2–5 минут — правам нужно время, чтобы распространиться. Шаг 9б. Выдай сервис-аккаунту доступ к приложению Даже с включённым API и рабочим ключом Google Play не пустит сервис-аккаунт к твоему приложению, пока ты явно не выдашь ему доступ. Симптом в vivaCRM: «Ключ отклонён: Google Play denied access to this app». Вернись в Google Play Console → раздел API access (там же, где создавал аккаунт). Напротив своего сервис-аккаунта нажми Grant access (Выдать доступ). Либо через общий раздел: слева внизу Users and permissions (Пользователи и разрешения) → Invite new user (Пригласить нового пользователя) → в поле email вставь адрес сервис-аккаунта (…@…iam.gserviceaccount.com из Шага 9). На вкладке App permissions (Разрешения для приложений) → Add app → выбери своё приложение. Отметь права на выпуск: - Release to testing tracks — публикация в тестовые треки (минимум для Internal testing), - при желании Release to production — публикация в продакшн. Либо на вкладке Account permissions дай Admin (all permissions), если не хочешь разбираться с отдельными галочками. Нажми Invite user → Send invitation (или Apply для Grant access). Сервис-аккаунт — не человек, письмо ему не приходит и подтверждать ничего не нужно. Доступ активен сразу после сохранения. Вернись в vivaCRM. Нажми Загрузить рядом с полем Ключ сервис-аккаунта Google Play (.json) и выбери скачанный на Шаге 9 JSON-файл. Шаг 134 Шаг 135 После загрузки vivaCRM проверит ключ. Если API включён (Шаг 9а) и доступ выдан (Шаг 9б) — ключ будет принят. Шаг 10. Сохрани настройки и перейди к сборке Нажми кнопку Сохранить, чтобы сохранить все заполненные параметры. Шаг 138 Прокрути страницу вниз и нажми на раздел «Соберите готовое приложение и скачайте файлы для публикации в App Store и Google Play», чтобы перейти к сборке Android-приложения. Шаг 140 Шаг 11. Загрузи первый релиз вручную Автоматическая публикация из vivaCRM не умеет создавать самый первый релиз приложения. Пока в Google Play Console нет ни одной загруженной версии, автопубликация будет отклоняться. Первый AAB нужно загрузить вручную — один раз. После этого все последующие сборки публикуются автоматически. После завершения сборки в vivaCRM скачай файл .aab (Android App Bundle) — это готовый пакет приложения для Google Play. Вернись в Google Play Console → Testing → Internal testing (Тестирование → Внутреннее тестирование) → Create new release (Создать новый выпуск). Загрузи скачанный .aab в блок App bundles. Нажми Next / Review release, при необходимости заполни описание изменений и нажми Start rollout to Internal testing (Начать публикацию во внутреннем тестировании). Перед первым релизом Google Play может потребовать заполнить обязательные разделы: политика конфиденциальности, контент-рейтинг, целевая аудитория, безопасность данных и т.д. Заполни их — без этого выпуск не запустится. Все необходимые настройки для Android-приложения заполнены, API включён, сервис-аккаунту выдан доступ, а первый релиз загружен вручную. Теперь все последующие сборки из vivaCRM будут публиковаться в Google Play автоматически. Частые ошибки при публикации | Ошибка в vivaCRM | Причина | Что сделать | | --------------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | PERMISSION_DENIED | Не включён Google Play Android Developer API | Шаг 9а — включить API в том же проекте Google Cloud, подождать 2–5 минут | | Google Play denied access to this app | Сервис-аккаунт не приглашён к приложению, либо приложение ещё не создано / нет первого релиза | Шаг 9б — выдать доступ (Grant access) с правом релиза; Шаг 11 — загрузить первый AAB вручную | | Ключ принят, но публикация не идёт | Не совпадает Application ID между vivaCRM, Google Play и Firebase | Проверить, что Application ID везде идентичен (Шаг 2) |