Как подключить push-уведомления для RuStore

ЭВ этой инструкции описан процесс подключения push-уведомлений для RuStore к приложению, зарегистрированному в edna Pulse. Такие приложения отображаются со статусом Подключено на экране данных push-канала.

Если ваше приложение ещё не зарегистрировано, воспользуйтесь инструкцией по подключению push-уведомлений для Android.

Убедитесь, что у вас есть:

  • проект приложения Android с minSdk не ранее 23 (Android 6) и targetSdk не позже 34 (Android 14);
  • учетная запись разработчика в консоли RuStore;
  • устройство Android версии 6.0 и выше;
  • актуальная версия Android Studio.
Библиотека edna работает с API 21 и выше, но RuStore SDK требует минимум API 23.

Шаг 1. Получите данные из консоли RuStore

Передайте своему персональному менеджеру в edna имя пакета приложения (app package), ID проекта и сервисный токен RuStore, чтобы мы активировали отправку сообщений в облако RuStore.

Для этого зарегистрируйте приложение в консоли RuStore, получите ID проекта и выпустите сервисный токен.

  1. В консоли разработчика RuStore добавьте приложение или выберите существующее.

2. В левом меню в разделе Push-уведомления выберите Проекты. Нажмите Добавить проект.

3. Укажите название проекта, имя пакета приложения (Android package name), отпечаток подписи SHA-256. Нажмите Создать. Проекту будет присвоен ID проекта.

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

5. Передайте своему персональному менеджеру в edna имя пакета приложения (app package), ID проекта и сервисный токен RuStore.

Шаг 2. Добавьте код интеграции

Для работы push-уведомлений необходимо соблюдение следующих условий:

  1. На устройстве пользователя должно быть установлено приложение RuStore. 
  2. Приложение RuStore должно поддерживать функциональность push-уведомлений. 
  3. Приложению RuStore разрешён доступ к работе в фоновом режиме. 
  4. Пользователь должен быть авторизован в приложении RuStore.

Обновите корневой build.gradle и файл build.gradle приложения, добавив следующие зависимости:

  1. В корневой build.gradle:
buildscript {
    repositories {
        jcenter()
        maven {
            url = uri("https://artifactory-external.vkpartner.ru/artifactory/maven")
       }
}

2. В app/build.gradle приложения:

defaultConfig {
  minSdkVersion 23
}

dependencies {
  implementation platform("com.edna.android:push-x-bom:2.3.2")
  implementation "com.edna.android:push-lite-rustore-release"     
}

3. В файл правил proguard-rules.pro добавьте следующее правило:

-keep public class com.vk.push.** extends android.os.Parcelable

4. Добавьте код инициализации RuStore в метод onCreate приложения:

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

После этого вы сможете отправлять push-уведомления в свое приложение через облако RuStore.