Перейти к основному содержимому

Подключение RuStore

Обновлено: 2 сентября 2026

RuStore Push — дополнительный канал доставки push-уведомлений на Android-устройства. Использование RuStore совместно с другими push-провайдерами позволяет повысить надёжность доставки сообщений. Для получения push-уведомлений необходимо:

  • установленное приложение RuStore;
  • поддержка Push API в приложении RuStore;
  • разрешение на работу RuStore в фоновом режиме;
  • авторизация пользователя в приложении RuStore.
warning

Начиная с версии библиотеки 3.11.0 поддерживается RuStore SDK 1.4.0, если выполняется одно из условий:

  • targetSdkVersion — 34;
  • используется зависимость ru.rustore.sdk:pushclient:1.0.0.

Добавление зависимостей​

Добавьте необходимые зависимости в корневой build.gradle и файл app/build.gradle.

Корневой build.gradle​

buildscript {
repositories {
jcenter()
maven {
url = uri("https://artifactory-external.vkpartner.ru/artifactory/maven")
}
}
}
warning

Для корректной работы с RuStore необходимо явно указать используемую версию okhttp. В противном случае Gradle может автоматически подключить версию Lite 5.2.1, несовместимую с RuStore SDK.

app/build.gradle с использованием BOM Рекомендуемый вариант​

defaultConfig {
minSdkVersion 26
}

dependencies {
releaseImplementation platform('com.edna.android:push-lite-bom-release:3.19.0')
releaseImplementation "com.edna.android:push-lite-rustore-release"

debugImplementation platform('com.edna.android:push-lite-bom-debug:3.19.0')
debugImplementation "com.edna.android:push-lite-rustore-debug"
}

app/build.gradle без использования BOM​

dependencies {
debugImplementation "com.edna.android:push-lite-rustore-debug:3.16.0"
releaseImplementation "com.edna.android:push-lite-rustore-release:3.16.0"
}

Регистрация приложения в RuStore​

подсказка

Для отправки push-уведомлений через RuStore потребуются:

  • appPackage;
  • Project ID;
  • Service Token.
  1. Перейдите в консоль разработчика RuStore.

  2. Выберите существующее приложение или создайте новое.

  3. Откройте раздел Push-уведомления → Проекты и нажмите Добавить проект.

  4. Укажите название проекта, Android package name и отпечаток сертификата SHA-256.

  5. Нажмите Создать — после этого проекту будет автоматически присвоен Project ID.

  6. Для генерации сервисного токена откройте раздел Сервисные токены и нажмите Создать.

  7. Сохраните полученный сервисный токен — он потребуется для настройки канала в edna.

  8. В классе Application вызовите инициализацию клиента RuStore Push.

    class App : Application() {
    override fun onCreate() {
    super.onCreate()
    RuStorePushClient().init(
    application = this,
    projectId = "ID_проекта",
    logger = DefaultLogger()
    )
    }
    }

Обработка уведомлений из других источников​

Если приложение получает push-уведомления не только через edna Push Service, можно переопределить обработку следующих событий:

  • получение нового RuStore Token;
  • получение входящего сообщения;
  • удаление недоставленных сообщений;
  • ошибки RuStore SDK.

Шаг 1. Создайте класс-наследник​

Создайте класс, наследующий com.edna.android.push_lite.RcmPushService, и переопределите необходимые методы.

import com.edna.android.push_lite.rustore.RcmPushService
import ru.rustore.sdk.pushclient.messaging.exception.RuStorePushClientException
import ru.rustore.sdk.pushclient.messaging.model.RemoteMessage

class CustomRuStoreMessagingService : RcmPushService() {

override fun onNewToken(token: String) {
// Обработка токена для собственных задач
}

override fun onMessageReceived(message: RemoteMessage) {
// Обработка уведомления
}

override fun onDeletedMessages() {
// Обработка недоставленных сообщений
}

override fun onError(errors: List<RuStorePushClientException>) {
// Обработка ошибок
}

}

Шаг 2. Зарегистрируйте сервис​

Добавьте сервис в раздел <application> файла AndroidManifest.xml.

<service
android:name=".CustomRuStoreMessagingService"
android:exported="true"
tools:ignore="ExportedService">

<intent-filter>
<action android:name="ru.rustore.sdk.pushclient.MESSAGING_EVENT" />
</intent-filter>

</service>