SDK Push-уведомления для Flutter (версия 6.0.1)

Ниже перечислены условия работы push-уведомлений.

Важно

• Подпись и package name различных типов сборок вашего приложения (debug, release и т.д.) могут отличаться друг от друга. В таком случае вы должны создать в разделе Push-уведомления > Проекты из RuStore Консоль проект под каждый тип сборки..

• Используется актуальная версия SDK.
• Загружены данные о приложении в разделе Push-уведомления > Проекты из RuStore Консоль.

• На устройстве пользователя установлено приложение-дистрибьютор (RuStore и т.д.)

  Для проверки того, что приложение-дистрибьютор установлено на устройстве пользователя, используйте метод RuStorePushClient.checkPushAvailability..
• Если установлено приложение RuStore, то ему разрешен доступ к работе в фоновом режиме. Без этого разрешения push-уведомления будут приходить, но со значительной задержкой.
• Отпечаток подписи приложения, установленного на девайсе, совпадает с отпечатком подписи приложения, которое добавлено в разделе Push-уведомления > Проекты из RuStore Консоль.

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

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

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

Для подключения пакета к проекту выполните следующую команду.

flutter pub add flutter_rustore_push

Она добавит строчку в файл pubspec.yaml.

pubspec.yaml

dependencies:
  flutter_rustore_push: ^6.0.1

Инициализация

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

Обратите внимание

Обратите внимание, что Push SDK не поддерживает работу в нескольких процессах одновременно.
Если ваше приложение использует несколько процессов, необходимо инициализировать SDK только в главном процессе.

Если инициализация происходит в дополнительном процессе, это может привести к некорректной работе push-уведомлений.

Добавьте в AndroidManifest.xml следующий код.

AndroidManifest.xml

<meta-data
    android:name="ru.rustore.sdk.pushclient.project_id"
    android:value="i5UTx96jw6c1C9LvdlE4cdNrWHMNyRBt"
    tools:replace="android:value" />

<meta-data
    android:name="ru.rustore.sdk.pushclient.params_class"
    android:value="com.example.FlutterRuStorePushClientParams" />

• projectId — идентификатор проекта из RuStore Консоль. Чтобы получить его, на странице приложения перейдите в раздел Push-уведомления > Проекты и скопируйте значение в поле ID проекта.
• (опционально) com.example.FlutterRuStorePushClientParams — полное имя класса своей реализации FlutterRuStorePushClientParams. Параметр нужен для указания дополнительных параметров инициализации push-клиента.

Вы можете создать его в своем приложении. Для этого добавьте в Android-модуль зависимости.

build.gradle

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

build.gradle

dependencies {
    implementation("ru.rustore.sdk:pushclient:6.0.1")
}

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

FlutterRuStorePushClientParams.kt

class FlutterRuStorePushClientParams(context: Context) : AbstractRuStorePushClientParams(context) {

    override fun getLogger(): Logger = DefaultLogger("your_tag")

    override fun getTestModeEnabled(): Boolean = false
}

Далее поместите в AndroidManifest.xml следующий код.

AndroidManifest.xml

<meta-data
    android:name="ru.rustore.sdk.pushclient.params_class"
    android:value="com.example.FlutterRuStorePushClientParams" />

предупреждение

В реализации класса AbstractRuStorePushClientParams должен быть только один конструктор с одним аргументом Context.

Настройки ProGuard

Для настройки ProGuard добавьте следующее правило.

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

В файле android/app/build.gradle добавьте следующие строки.

android/app/build.gradle

buildTypes {
    release {
        // ...
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
}

Проверка возможности получать push-уведомления

Для проверки того, что приложение-дистрибьютор установлено на устройстве пользователя, используйте метод RustorePushClient.available().

RustorePushClient.available().then((value) {
    print("available success: ${value}");
}, onError: (err) {
    print("available error: ${err}");
   }
);

Методы для работы с push-токеном

Получение push-токена пользователя

предупреждение

Если у пользователя нет push-токена, метод создаст и вернёт новый push-токен.

После инициализации библиотеки вы можете использовать метод RuStorePushClient.getToken(), чтобы получить текущий push-токен пользователя.

RustorePushClient.getToken().then((value) {
    print("get token success: ${value}" );
}, onError: (err) {
    print("get token error: ${err}" );
   }
);

Удаление push-токена пользователя

После инициализации библиотеки вы можете использовать метод RuStorePushClient.deleteToken(), чтобы удалить текущий push-токен пользователя.

RustorePushClient.deleteToken().then(() {
    print( "delete success:" );
}, onError: (err) {
    print( "delete error: ${err}" );
   }
);

Методы работы с push-топиком

Подписка на push-уведомления по топику

После инициализации библиотеки вы можете использовать метод RuStorePushClient.subscribeToTopic(your_topic_name) для подписки на топик.

RustorePushClient.subscribeToTopic("topicName").then((value) {
    //Proccess success
}, onError: (err) {
    //Process error
   }
);

Отписка от push-уведомлений по топику

После инициализации библиотеки вы можете использовать метод RuStorePushClient.unsubscribeFromTopic(your_topic_name) для отписки от топика.

RustorePushClient.unsubscribeFromTopic("topicName").then((value) {
    //Proccess success
}, onError: (err) {
    //Process error
   }
);

Подписка на события

Вы можете подписаться на события SDK, для этого вызовите метод RustorePushClient.attachCallbacks и добавьте интересующие вас события.

RustorePushClient.attachCallbacks(
    Function? onDeletedMessages,
    Function? onError,
    Function? onMessageReceived,
    Function? onNewToken,
)

Удаление push-уведомления

Чтобы получить информацию об удалении push-уведомления добавьте callback onDeletedMessages.

onDeletedMessages: () {
    print("on delete messages");
}

События изменения push-токена

Иногда старый токен становится некорректным, он может выписываться заново. Чтобы узнать о том, что выписался новый токен, используйте callback onNewToken.

onNewToken((value) {
    print("on new token success: ${value}");
}

Получение информации из push-уведомления

Чтобы получить информацию из push-уведомления, добавьте callback onMessageReceived.

onMessageReceived((value) {
    print("on message received success: id=${value.messageId}, data=${value.data}, notification.body: ${value.notification?.body}");
}

Для получения уведомления по которому было открыто приложение, добавьте callback getInitialMessage

RustorePushClient.getInitialMessage().then((value) {
    print("getInitialMessage from dart called: ${value?.notification?.title}");
},

Событие ошибки в момент инициализации

Если в момент инициализации возникает ошибка, вызывается callback onError.

onError: (value) {
    print("on error: ${value}");
}

Структура уведомления

Структура полного уведомления

class Message {
    String? messageId;
    int priority;
    int ttl;
    String? collapseKey;
    Map<String?, String?> data;
    Notification? notification;
}

• messageId — уникальный ID сообщения. Является идентификатором каждого сообщения.
• priority — возвращает значение приоритетности (на данный момент не учитывается). Сейчас заложены следующие варианты:
  • 0 — UNKNOWN;
  • 1 — HIGH;
  • 2 — NORMAL.
• ttl — время жизни push-уведомления типа Int в секундах.
• from — поле, по которому можно понять, откуда пришло уведомление:
  • для уведомлений, отправленных в топик, в поле отображается имя топика;
  • в других случаях — часть вашего сервисного токена.
  .
• collapseKey — идентификатор группы уведомлений (на данный момент не учитывается).
• data — словарь, в который можно передать дополнительные данные для уведомления.
• rawData — словарь data в виде массива байтов.
• notification — объект уведомления.

Структура объекта Notification

class Notification {
    String? title;
    String? body;
    String? channelId;
    String? imageUrl;
    String? color;
    String? icon;
    String? clickAction;
}

• title — заголовок уведомления.
• body — тело уведомления.
• channelId — возможность задать канал, в который отправится уведомление. Актуально для Android 8.0 и выше.
• imageUrl — прямая ссылка на изображение для вставки в уведомление. Изображение должно быть не более 1 Мбайт.
• color — цвет уведомления в HEX-формате, строкой. Например, #0077FF.
• icon — значок уведомления из res/drawable в формате строки, которая совпадает с названием ресурса.
  Например, в res/drawable есть значок small_icon.xml, который доступен в коде через R.drawable.small_icon.
  Чтобы значок отображался в уведомлении, сервер должен указать в параметре icon значение small_icon.
• clickAction — intent action, с помощью которого будет открыта активити при клике на уведомление.

Создание канала для отправки уведомления

Для канала, в который отправляется уведомление, действует следующий приоритет.

• Если в push-уведомлении есть поле channelId, RuStore SDK отправит уведомление в указанный канал. Ваше приложение должно создать этот канал заранее.

• Если в push-уведомлении нет поля channelId, но ваше приложение указало параметр с каналом в AndroidManifest.xml, используется указанный канал. Ваше приложение должно создать этот канал заранее.

• Если в push-уведомлении нет поля channelId, и канал по умолчанию не задан в AndroidManifest.xml, RuStore SDK создаст канал и отправит уведомление в него. В дальнейшем все уведомления без явного указания канала будут отправляться в этот канал.

См. также

• Отправка push-уведомлений (API)
• Отправка push-уведомлений по топикам (API)