RuStore Push SDK можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. RuStore Push SDK выдаёт токен устройства и доставляет уведомления через российскую инфраструктуру без обязательного Firebase Cloud Messaging. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.
Частая ошибка состоит в том, что SDK добавили как зависимость, но не создали проект в консоли, не инициализировали клиент или не сохранили новый токен. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте Android-приложение, которое получает push-токен, показывает его короткий отпечаток и принимает тестовое уведомление. Проверка: getToken возвращает строку, токен записан на тестовый backend, а уведомление появляется на устройстве в ожидаемом канале.
создать push-проект в RuStore Консоли. Не расширяйте проект до первого успешного запуска.
клиент готов до вызова getToken. Проверяйте значение, а не отсутствие ошибки.
После успеха добавьте отдельный канал updates и обработку нового токена. Так копирование станет практикой.
Как устроен учебный проект RuStore Push SDK
Application инициализирует RuStorePushClient с projectId, экран запрашивает токен, а отправка выполняется через консоль или серверный Push API. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.
| Этап | Действие | Проверяемый результат |
|---|---|---|
| Проект | создать push-проект в RuStore Консоли | получен projectId для приложения |
| SDK | инициализировать RuStorePushClient в Application | клиент готов до вызова getToken |
| Токен | вызвать getToken и обработать Task | получена непустая строка токена |
| Сообщение | отправить тестовый push из консоли | уведомление видно на устройстве |
Контрольные точки: проект, sdk, токен и сообщение. Следующий шаг начинается после совпадения с ожидаемым результатом.

От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.
Собираем рабочий пример шаг за шагом
Материал сверялся с документацией 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 Консоли появляется один раз и открывает ожидаемый экран.
- Повторный запуск даёт тот же предсказуемый результат.
- Пустой ввод получает понятное сообщение вместо падения.
Главная функция принимает явный вход и возвращает результат, который можно проверить отдельно от интерфейса. Найдите в примере вход, проверку и место формирования результата.

Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.
Что происходит внутри и почему это работает
Push-токен связывает установку приложения с сервисом доставки. Токен может измениться, поэтому backend должен уметь обновлять значение, удалять старое и не считать его постоянным идентификатором пользователя. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Начиная с SDK 7.4 инициализация может выполняться в фоновом потоке, но стартовать должна из Application.onCreate. getToken ждёт инициализацию ограниченное время и может вернуть SdkIsNotInitializedException.
| Часть | За что отвечает | Что проверить |
|---|---|---|
| RuStore Консоль | создаёт проект и тестовое сообщение | package name и подпись совпадают |
| Push client | инициализирует SDK и выдаёт токен | ошибка Task обработана |
| Backend | хранит токены и отправляет сообщения | секрет сервиса остаётся на сервере |
Не печатайте полный токен в публичный лог и не кладите сервисный ключ отправки в APK. Клиент получает токен, а сервер хранит авторизацию Push API и решает, кому отправить сообщение. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.
Проверяем проект и добавляем свою функцию
Создайте NotificationChannel, добавьте экран настроек уведомлений и отправьте data-сообщение с безопасным идентификатором заметки. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.
- Сохраните ожидаемый результат: getToken возвращает строку, токен записан на тестовый backend, а уведомление появляется на устройстве в ожидаемом канале.
- Измените правило: добавьте отдельный канал updates и обработку нового токена. Сначала предскажите итог.
- Передайте граничное значение и убедитесь, что приложение не падает.
- Верните корректные данные и объясните роли трёх основных частей.
- получен projectId для приложения
- клиент готов до вызова getToken
- получена непустая строка токена
- уведомление видно на устройстве
После изменения повторите основной и ошибочный сценарии, чтобы новое поведение не сломало исходный результат. Полезная правка проходит от нового ввода до видимого результата.

Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.
Что запомнить и куда двигаться дальше
Перед production настройте согласие пользователя, отписку, очистку недействительных токенов и серверную статистику успешных и ошибочных отправок. Для закрепления откройте в первом Android-приложении, в публикации приложения в RuStore и в простом backend API.
Как изучить тему в Кодике
Сначала разберите формат входных данных и одну функцию, затем подключайте внешний сервис или интерфейс. Сначала восстановите главную функцию и проверьте её на трёх значениях.
| Шаг | Что разобрать | Мини-проверка |
|---|---|---|
| 1. Основа | Классы, callback и null-safety Kotlin | Объясните вход и выход функции. |
| 2. Инструмент | Application, AndroidManifest и Task API RuStore | Повторите команду по памяти. |
| 3. Проект | Получение токена и тестовый push | Проверьте два сценария. |
| 4. Рефакторинг | Серверную отправку, каналы и ротацию токенов | Разделите ввод, логику и вывод. |
Закрепите проект, восстановив ключевую функцию по памяти и добавив собственный граничный случай. Базовый синтаксис закрепите через курс Kotlin.
Его можно извлечь. Отправляйте push только с backend.
Логи могут попасть в отчёты. Показывайте только короткий отпечаток.
Task завершается ошибкой. Стартуйте SDK в Application.onCreate.
Debug и release могут требовать отдельные проекты в консоли.
Что получится в итоге

Финальный экран показывает результат, состояние операции и понятное сообщение об ошибке без раскрытия секретов.
Где должен лежать ключ Push API?
Только на сервере. Android-приложение получает токен устройства, но не секрет отправителя.
Может ли push-токен измениться?
Да. Backend должен обновлять значение и удалять недействительные токены.
Что проверять первым, если RuStore Push SDK не запускается?
Версию среды, текущую папку, команду запуска и первую строку ошибки.
Как понять, что проект RuStore Push SDK работает?
Проверьте основной сценарий, неверный ввод, повторный запуск и один граничный случай.
Можно ли начать с готового кода?
Да. Добейтесь результата, измените одно правило и восстановите ключевую функцию без копирования.
Выберите одно улучшение и проведите его от ввода до результата.
Если не хватает основы, перейдите курс Kotlin, затем восстановите ключевую функцию без подсказки.