Общая информация

RuStore SDK для универсальных пуш-уведомлений — это набор пакетов для работы с пуш-уведомлениями. Отправляйте и получайте сообщения через несколько каналов:

FCM — Firebase Cloud Messaging;
HMS — Huawei Mobile Services;
RuStore.

Используйте SDK в связке с уже настроенными сервисами HMS и FCM.

Пример реализации

Ознакомьтесь с приложением-примером чтобы узнать, как правильно интегрировать универсальные пуш-уведомления.

Условия работы пуш-уведомлений

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

На устройстве пользователя должно быть установлено приложение RuStore.
Приложение RuStore должно поддерживать функциональность пуш-уведомлений.
Приложению RuStore разрешен доступ к работе в фоновом режиме.
Пользователь должен быть авторизован в приложении RuStore.
Отпечаток подписи приложения должен совпадать с отпечатком, добавленным в консоль разработчика.

Настройка приложения

Для инициализации понадобится ID проекта, который можно получить в «RuStore Консоль». На странице приложения перейдите в раздел «Push-уведомления» и выберите «Проекты».

Подключение в проект

Подключите репозитории в файле settings.gradle:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {url = uri("https://developer.huawei.com/repo/")}
        maven {
            url = uri("https://artifactory-external.vkpartner.ru/artifactory/maven")
        }
    }
}

Подключение зависимостей

Для подключения зависимости добавьте в свой файл build.gradle на уровне app следующий код:

dependencies {
    implementation('ru.rustore.sdk:universalpush:0.1.2')
    implementation('ru.rustore.sdk:universalrustore:0.1.2')
    implementation('ru.rustore.sdk:universalhms:0.1.2')
    implementation('ru.rustore.sdk:universalfcm:0.1.2')
}

При использовании RuStore Push SDK в вашем приложении вместе с ProGuard добавьте следующее правило:

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

Это необходимо только для работы пакета ru.rustore.sdk:universalrustore.

Для работы с FCM и HMS нужно:

добавить в build.gradle на уровне app

plugins {
    // ...
 
    // нужно для fcm
    id 'com.google.gms.google-services'
    // нужно для hms
    id 'com.huawei.agconnect'
}

добавить в build.gradle на корневом уровне

dependencies {
    // нужно для fcm
    classpath 'com.google.gms:google-services:4.3.15'
    // нужно для hms
    classpath 'com.huawei.agconnect:agcp:1.6.0.300'
    classpath 'com.android.tools.build:gradle:7.4.0'
}

добавить в settings.gradle на корневом уровне

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
        //  нужно для работы hms
        maven {url = uri("https://developer.huawei.com/repo/")}
    }
}

Google Play

Huawei Mobile Services

Обновлено 7 июня 2023 г.