Эта инструкция проведёт тебя через все шаги: от настройки основных параметров в vivaCRM до создания приложения в Google Play Console и подключения Firebase для пуш-уведомлений.
Убедись, что у тебя уже есть зарегистрированный аккаунт разработчика в Google Play Console и проект в Firebase. Если нет — сначала прочитай нашу статью о регистрации в Google Play Console.
Шаг 1. Открой настройки мобильного приложения в vivaCRM
Нажми на раздел Управление в верхнем меню, чтобы перейти к настройкам системы.
В выпадающем меню выбери Основные настройки.
Нажми на вкладку Мобильное приложение.
Нажми на блок Сертификаты доступов и основная информация — именно с этого шага начинается подготовка к запуску релиза Android-приложения.
Шаг 2. Заполни основные параметры приложения
Нажми на поле Название приложения и введи название своего приложения. Запомни его — оно понадобится при создании приложения в Google Play Console.
Поля Публичный номер версии и Внутренний код версии заполнять на этом этапе не обязательно. Настройки под iOS можно пропустить и сразу перейти к блоку Android.
Найди поле Android Application ID и нажми на иконку копирования рядом с ним. Этот идентификатор понадобится при создании приложения в Google Play Console и в Firebase.
Один и тот же Android Application ID должен использоваться везде: в vivaCRM, при создании приложения в Google Play Console и при добавлении приложения в Firebase. После первой публикации в Google Play изменить его невозможно — если он где-то разойдётся хоть на один символ, публикация упадёт с ошибкой «denied access to this app».
Шаг 3. Создай приложение в Google Play Console
Перейди в Google Play Console и нажми кнопку Создать приложение.
В поле Название приложения введи то же название, которое ты указывал в настройках vivaCRM.
Нажми на поле App package name и вставь скопированный ранее Android Application ID из настроек vivaCRM.
Нажми на поле языка (по умолчанию стоит Английский (Соединенные Штаты) – en-US) и выбери Русский – ru-RU или другой язык, актуальный для твоего приложения.
- Выбери тип «Приложение» (не «Игра»).
- Выбери «Бесплатно» — само приложение скачивается бесплатно, платные услуги внутри него при этом возможны.
Поставь обе галочки: согласие с правилами программы для разработчиков Google Play и с экспортным законодательством США.
Нажми кнопку Создать приложение.
Шаг 4. Настрой внутреннее тестирование
После создания приложения ты попадёшь в панель управления. Нажми Просмотреть задачи, чтобы развернуть список необходимых шагов.
Нажми Выберите тестировщиков, чтобы добавить участников внутреннего тестирования.
Нажми Создать список рассылки.
Введи любое название списка в поле Название списка, например vivaCRM Test.
В поле Добавьте адреса электронной почты введи e-mail и нажми Enter.
Нажми Сохранить изменения.
Нажми Создать, чтобы подтвердить создание списка.
:::
При необходимости добавь ещё один e-mail в поле Добавьте адреса электронной почты, нажми Enter для подтверждения.
Нажми Сохранить изменения, затем Создать и финально Сохранить.
Пункт Выберите тестировщиков должен быть отмечен как выполненный.
Нажми Создайте новый выпуск, чтобы перейти к загрузке первой версии приложения. Пока что оставь эту страницу открытой — вернёшься к ней позже.
Шаг 5. Настрой ссылки интеграции в vivaCRM
Вернись в vivaCRM → Основные настройки → Мобильное приложение → Сертификаты доступов и основная информация.
Найди поле URL-схема и введи удобное название — оно будет использоваться для открытия приложения по прямым ссылкам на Android и iOS (например, embargopp://).
Поле Домен Universal Links (iOS) можно пропустить, если не знаешь, для чего оно нужно.
Шаг 6. Подключи Firebase для пуш-уведомлений
Перейди на console.firebase.google.com. Выбери свой существующий проект из списка или создай новый с помощью Create a new Firebase project.
Внутри проекта нажми кнопку Add app и выбери платформу Android.
В поле Android Package Name вставь скопированный ранее Android Application ID из vivaCRM.
В поле App Nickname введи название своего мобильного приложения.
Нажми Register app.
На следующем шаге нажми Download google-services.json — этот файл понадобится для загрузки в vivaCRM.
Нажми Next, пропусти шаг с настройкой Firebase SDK и нажми Next ещё раз.
Нажми Continue to console.
В Firebase перейди в Settings → General.
Скопируй значение Project ID — оно понадобится для поля FCM Sender ID в vivaCRM.
Вернись в vivaCRM и вставь скопированный Project ID в поле FCM Sender ID.
Шаг 7. Загрузи иконки и конфигурационные файлы
Нажми Загрузить рядом с полем иконки приложения и выбери файл размером 1024×1024 пикселей.
:::
Сплэш-экран — это первое, что видит пользователь при открытии приложения.
- Нажми Загрузить для светлой темы и выбери логотип на светлом фоне.
- Нажми Загрузить для тёмной темы и выбери логотип, хорошо видимый на тёмном фоне.
Нажми Загрузить рядом с полем google-services.json (Android) и выбери скачанный ранее из Firebase конфигурационный файл.
Шаг 8. Получи и загрузи Service Account из Firebase
В Firebase Console открой Settings → Service Accounts.
Нажми Generate new private key.
В появившемся окне подтверди, нажав Generate key — файл JSON автоматически скачается.
Вернись в vivaCRM. Нажми Загрузить рядом с полем Service Account (JSON, отправка push) и выбери скачанный файл.
Шаг 9. Получи ключ сервис-аккаунта Google Play
-
Service Account из Firebase (Шаг 8) — нужен только для отправки push-уведомлений.
-
Ключ сервис-аккаунта Google Play (этот шаг) — нужен для автоматической публикации сборок в Google Play.
Это разные файлы из разных мест. Ниже — про второй, публикующий.
Перейди на главную страницу Google Play Console (не внутрь конкретного приложения) и нажми Настройки (Setup) в левом меню, затем — раздел API access (Доступ к API).
В разделе 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-файл.
После загрузки vivaCRM проверит ключ. Если API включён (Шаг 9а) и доступ выдан (Шаг 9б) — ключ будет принят.
Шаг 10. Сохрани настройки и перейди к сборке
Нажми кнопку Сохранить, чтобы сохранить все заполненные параметры.
Прокрути страницу вниз и нажми на раздел «Соберите готовое приложение и скачайте файлы для публикации в App Store и Google Play», чтобы перейти к сборке Android-приложения.
Шаг 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) |