Подключение RuStore
RuStore Push — дополнительный канал доставки push-уведомлений на Android-устройства. Использование RuStore совместно с другими push-провайдерами позволяет повысить надёжность доставки сообщений. Для получения push-уведомлений необходимо:
- установленное приложение RuStore;
- поддержка Push API в приложении RuStore;
- разрешение на работу RuStore в фоновом режиме;
- автор изация пользователя в приложении RuStore.
Начиная с версии библиотеки 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")
}
}
}
Для корректной работы с 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.
-
Перейдите в консоль разработчика RuStore.
-
Выберите существующее приложение или создайте новое.
-
Откройте раздел Push-уведомления → Проекты и нажмите Добавить проект.
-
Укажите название проекта, Android package name и отпечаток сертификата SHA-256.
-
Нажмите Создать — после этого проекту будет автоматически присвоен Project ID.
-
Для генерации сервисного токена откройте раздел Сервисные токены и нажмите Создать.
-
Сохраните полученный сервисный токен — он потребуется для настройки канала в edna.
-
В классе
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>