Мобильные приложенияБэкендJava / Kotlin

Push-уведомления RuStore без Firebase: подключаем их в Android-приложение

Подключаем RuStore Push SDK 7.5 к Android-приложению на Kotlin: инициализируем клиент, получаем токен и отправляем тестовое уведомление.

Кодик

Автор

6 мин чтения

RuStore Push SDK можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. RuStore Push SDK выдаёт токен устройства и доставляет уведомления через российскую инфраструктуру без обязательного Firebase Cloud Messaging. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.

Частая ошибка состоит в том, что SDK добавили как зависимость, но не создали проект в консоли, не инициализировали клиент или не сохранили новый токен. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте Android-приложение, которое получает push-токен, показывает его короткий отпечаток и принимает тестовое уведомление. Проверка: getToken возвращает строку, токен записан на тестовый backend, а уведомление появляется на устройстве в ожидаемом канале.

1Соберите минимум

создать push-проект в RuStore Консоли. Не расширяйте проект до первого успешного запуска.

2Увидьте данные

клиент готов до вызова getToken. Проверяйте значение, а не отсутствие ошибки.

3Измените правило

После успеха добавьте отдельный канал updates и обработку нового токена. Так копирование станет практикой.

Как устроен учебный проект RuStore Push SDK

Application инициализирует RuStorePushClient с projectId, экран запрашивает токен, а отправка выполняется через консоль или серверный Push API. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.

ЭтапДействиеПроверяемый результат
Проектсоздать push-проект в RuStore Консолиполучен projectId для приложения
SDKинициализировать RuStorePushClient в Applicationклиент готов до вызова getToken
Токенвызвать getToken и обработать Taskполучена непустая строка токена
Сообщениеотправить тестовый push из консолиуведомление видно на устройстве

Контрольные точки: проект, sdk, токен и сообщение. Следующий шаг начинается после совпадения с ожидаемым результатом.

Путь данных в проекте RuStore Push SDK
От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.

Зафиксируйте первый успех Проверьте package name, подпись тестовой сборки и projectId. Один проект в консоли должен соответствовать конкретной комбинации приложения и подписи. Сохраните команду запуска и ожидаемый вывод.

Собираем рабочий пример шаг за шагом

Материал сверялся с документацией RuStore Push SDK 7.5.0 2 ноября 2026 года. Подключите актуальную ветку RuStore Push SDK 7.5.0 по официальной инструкции и объявите свой класс Application в AndroidManifest.xml. Проверьте текущую папку через pwd или Get-Location. Вставьте пример целиком, выполните один раз, затем разбирайте по частям.

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        RuStorePushClient.init(
            application = this,
            projectId = BuildConfig.RUSTORE_PUSH_PROJECT_ID,
            logger = DefaultLogger("PushDemo"),
        )
    }
}

fun loadPushToken(onReady: (String) -> Unit, onError: (Throwable) -> Unit) {
    RuStorePushClient.getToken()
        .addOnSuccessListener { token ->
            if (token.isBlank()) onError(IllegalStateException("Пустой push-токен"))
            else onReady(token)
        }
        .addOnFailureListener(onError)
}
Что должно произойти после запуска
  • После запуска Logcat показывает успешную инициализацию без полного токена.
  • Тестовое сообщение из RuStore Консоли появляется один раз и открывает ожидаемый экран.
  • Повторный запуск даёт тот же предсказуемый результат.
  • Пустой ввод получает понятное сообщение вместо падения.

Главная функция принимает явный вход и возвращает результат, который можно проверить отдельно от интерфейса. Найдите в примере вход, проверку и место формирования результата.

Хрупкий и проверяемый вариант RuStore Push SDK
Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.

Что происходит внутри и почему это работает

Push-токен связывает установку приложения с сервисом доставки. Токен может измениться, поэтому backend должен уметь обновлять значение, удалять старое и не считать его постоянным идентификатором пользователя. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Начиная с SDK 7.4 инициализация может выполняться в фоновом потоке, но стартовать должна из Application.onCreate. getToken ждёт инициализацию ограниченное время и может вернуть SdkIsNotInitializedException.

ЧастьЗа что отвечаетЧто проверить
RuStore Консольсоздаёт проект и тестовое сообщениеpackage name и подпись совпадают
Push clientинициализирует SDK и выдаёт токеношибка Task обработана
Backendхранит токены и отправляет сообщениясекрет сервиса остаётся на сервере

Не печатайте полный токен в публичный лог и не кладите сервисный ключ отправки в APK. Клиент получает токен, а сервер хранит авторизацию Push API и решает, кому отправить сообщение. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.

Проверьте границу Запустите приложение без projectId, затем с корректным идентификатором. Ошибки должны попасть в обработчик, а не исчезнуть в пустом экране. Меняйте одно условие за прогон, чтобы видеть причину.

Проверяем проект и добавляем свою функцию

Создайте NotificationChannel, добавьте экран настроек уведомлений и отправьте data-сообщение с безопасным идентификатором заметки. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.

Проверка своими руками
  1. Сохраните ожидаемый результат: getToken возвращает строку, токен записан на тестовый backend, а уведомление появляется на устройстве в ожидаемом канале.
  2. Измените правило: добавьте отдельный канал updates и обработку нового токена. Сначала предскажите итог.
  3. Передайте граничное значение и убедитесь, что приложение не падает.
  4. Верните корректные данные и объясните роли трёх основных частей.
Готово, если выполняются все пункты
  • получен projectId для приложения
  • клиент готов до вызова getToken
  • получена непустая строка токена
  • уведомление видно на устройстве

После изменения повторите основной и ошибочный сценарии, чтобы новое поведение не сломало исходный результат. Полезная правка проходит от нового ввода до видимого результата.

Четыре контрольные точки RuStore Push SDK
Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.

Что запомнить и куда двигаться дальше

Перед production настройте согласие пользователя, отписку, очистку недействительных токенов и серверную статистику успешных и ошибочных отправок. Для закрепления откройте в первом Android-приложении, в публикации приложения в RuStore и в простом backend API.

Как изучить тему в Кодике

Сначала разберите формат входных данных и одну функцию, затем подключайте внешний сервис или интерфейс. Сначала восстановите главную функцию и проверьте её на трёх значениях.

ШагЧто разобратьМини-проверка
1. ОсноваКлассы, callback и null-safety KotlinОбъясните вход и выход функции.
2. ИнструментApplication, AndroidManifest и Task API RuStoreПовторите команду по памяти.
3. ПроектПолучение токена и тестовый pushПроверьте два сценария.
4. РефакторингСерверную отправку, каналы и ротацию токеновРазделите ввод, логику и вывод.

Закрепите проект, восстановив ключевую функцию по памяти и добавив собственный граничный случай. Базовый синтаксис закрепите через курс Kotlin.

Секрет отправки в APK

Его можно извлечь. Отправляйте push только с backend.

Полный токен в Logcat

Логи могут попасть в отчёты. Показывайте только короткий отпечаток.

Инициализация после getToken

Task завершается ошибкой. Стартуйте SDK в Application.onCreate.

Один projectId для разных подписей

Debug и release могут требовать отдельные проекты в консоли.

Сверяйтесь с первичной документацией. Команды и ограничения примера проверены по официальному источнику 1. Если версия инструмента изменилась, официальный источник важнее старого скриншота.

Что получится в итоге

Готовый результат проекта: Push-уведомления RuStore без Firebase: подключаем их в Android-приложение
Финальный экран показывает результат, состояние операции и понятное сообщение об ошибке без раскрытия секретов.

Короткие ответы
Где должен лежать ключ Push API?

Только на сервере. Android-приложение получает токен устройства, но не секрет отправителя.

Может ли push-токен измениться?

Да. Backend должен обновлять значение и удалять недействительные токены.

Что проверять первым, если RuStore Push SDK не запускается?

Версию среды, текущую папку, команду запуска и первую строку ошибки.

Как понять, что проект RuStore Push SDK работает?

Проверьте основной сценарий, неверный ввод, повторный запуск и один граничный случай.

Можно ли начать с готового кода?

Да. Добейтесь результата, измените одно правило и восстановите ключевую функцию без копирования.

Сделайте один осознанный шаг дальше

Выберите одно улучшение и проведите его от ввода до результата.

Если не хватает основы, перейдите курс Kotlin, затем восстановите ключевую функцию без подсказки.