Outsystems: Часто задаваемые вопросы

Q: Управление файлами google-services в проектах с несколькими возможными именами пакетов

В плагине вы можете добавить несколько файлов google-services.json в свой проект, и нужный файл будет выбран на основе имени пакета, установленного во время сборки. Создайте ZIP-архив с именем google-services.zip, содержащий каждый файл google-services.json, добавьте этот ZIP-файл в проект с действием Deploy to Target Directory и укажите целевой каталог как google-services/имя_пакета (например, google-services/com.pushwoosh.demo). Во время сборки проекта укажите соответствующее имя пакета.

Q: Каждое новое уведомление на Android заменяет предыдущее

По умолчанию Pushwoosh Android SDK отправляет каждый push с одним и тем же идентификатором уведомления, поэтому новый push заменяет предыдущий. Начиная с версии компонента Pushwoosh Plugin 4.7.0, добавьте клиентское действие SetMultiNotificationMode в поток, который запускается после инициализации (например, в обработчик OnInitializeOver, после RegisterDevice) — тогда каждый push будет отображаться как отдельное уведомление. Android группирует их в один расширяемый стек, что является стандартным поведением системы.

Управление файлами google-services в проектах с несколькими возможными именами пакетов

В плагине вы можете добавить несколько файлов google-service.json в свой проект, и нужный файл будет выбран на основе имени пакета, установленного во время сборки.

Если вы хотите переключаться между несколькими проектами Firebase (каждый со своим файлом конфигурации google-services.json), выполните следующие действия:

Создайте ZIP-архив. Поместите каждый файл google-services.json в .zip-архив с именем google-services.zip.
При добавлении этого .zip-файла в проект установите для него действие Deploy to Target Directory и укажите целевой каталог как google-services/${package_name}.

Например, если имя пакета проекта — com.pushwoosh.demo, целевым каталогом будет google-services/com.pushwoosh.demo.

Во время сборки проекта укажите соответствующее имя пакета.

Разрешение конфликтов между несколькими плагинами, зависящими от FirebaseMessagingService

Android не разрешает такие конфликты автоматически, поэтому это нужно делать вручную. Поскольку у каждого плагина своя логика, мы не можем предоставить универсальный код, который будет работать для всех возможных плагинов.

Вот как можно разрешить конфликты:

Напишите класс-маршрутизатор на Java для обработки конфликта. Этот класс должен называться FirebaseMessagingRouterService.

Пример см. в руководстве: Использование Pushwoosh SDK с другими сервисами FCM.

Назовите файл класса. Файл, содержащий этот класс, должен называться FirebaseMessagingRouterService.java.
Поместите этот файл в .zip-архив с именем FirebaseMessagingRouterService.zip.
Добавьте этот архив в ресурсы вашего проекта Outsystems.
Установите для него действие Deploy to Target Directory и укажите целевой каталог как FirebaseMessagingRouterService.

Каждое новое уведомление на Android заменяет предыдущее

По умолчанию Pushwoosh Android SDK работает в режиме одного уведомления: каждый push отправляется с одним и тем же идентификатором уведомления, поэтому каждый новый заменяет предыдущий. Это не связано с производителем устройства или с collapse_key.

Начиная с версии компонента Pushwoosh Plugin 4.7.0, включите группировку с помощью готового клиентского действия SetMultiNotificationMode:

Обновите компонент Pushwoosh Plugin из Forge.
Обновите зависимость к модулю PushwooshPlugin (Manage Dependencies).
Добавьте SetMultiNotificationMode в поток, который запускается после инициализации — например, в обработчик события OnInitializeOver, сразу после RegisterDevice. Действие не принимает параметров, и один успешный вызов сохраняется в SDK и остается действительным после перезапусков.

После этого каждый push будет отображаться как отдельное уведомление. Android группирует их в один расширяемый стек со счетчиком — это стандартная системная группировка. Примечание: push-уведомления, отправленные со значением android_tag, по-прежнему заменяют друг друга независимо от режима.