Outsystems

Установка плагина Pushwoosh

Начните с установки плагина Pushwoosh из OutSystems Forge. Самый быстрый способ сделать это — перейти на вкладку OutSystems в вашей среде разработки и установить его оттуда.

Настройка Pushwoosh

Вам потребуется настроить Pushwoosh для каждой из платформ, которые вы будете поддерживать. После завершения настройки у вас будет Application Code от Pushwoosh, который будет использоваться с вашим плагином.

Для iOS

Узнайте, как настроить Pushwoosh для iOS.

Для Android

Узнайте, как настроить Pushwoosh для Android.

Добавление плагина Pushwoosh в ваше приложение

1. В вашем приложении используйте «Manage Dependencies…», чтобы добавить ссылку на плагин Pushwoosh.

2. Добавьте блок «PushwooshNotifications» в:

   • Блок «Layout», если в вашем приложении нет входа в систему
   • Блок «LayoutBlank», если в вашем приложении есть вход в систему

   При добавлении блока «PushwooshNotifications» избегайте его размещения внутри плейсхолдеров, так как некоторые из них доступны только во время разработки, и во время выполнения Pushwoosh не будет работать.

3. Установите следующие параметры в PushwooshNotifications:

   • PushwooshApplicationCode: Код Pushwoosh, который вы получили после создания приложения в Pushwoosh.
   • FCMSenderId: Идентификационный номер, который вы получили при настройке Android. Вы можете оставить это поле пустым, если ваше приложение доступно только для iOS.
   • NotificationReceivedEvent (необязательно): Событие, которое вызывается при получении уведомления, когда приложение находится в активном состоянии (на переднем плане).
   • NotificationOpenedEvent (необязательно): Событие, которое вызывается, когда пользователь нажимает на уведомление на своем устройстве.

Если вы используете плагин Pushwoosh в своем приложении для Android, выполните следующие действия:

1. Получите google-services.json из Firebase. Имя пакета из сервисов Google должно совпадать с идентификатором создаваемого приложения OutSystems.
2. Создайте zip-файл, содержащий google-services.json в корневом каталоге.
3. Загрузите файл «google-services.zip» из предыдущего шага в ваше приложение OutSystems и убедитесь, что:
   • Установлено «Name» как «google-services.zip»
   • Установлено «Deploy to Target Directory» как «google-services»

Чтобы ваше устройство могло получать push-уведомления, вам необходимо его зарегистрировать. Если вашим пользователям необходимо войти в систему для использования приложения, перейдите на экран «Login» и отредактируйте действие «Login».

Добавьте код для регистрации устройства после действия «DoLogin». Он должен выглядеть примерно так:

Если в вашем приложении нет входа в систему, вы можете добавить этот код в событие OnInitializeOver в блоке PushwooshNotifications.

В этом обработчике событий вызовите действие RegisterDevice.

Если вы генерируете мобильное приложение для iOS с использованием сертификата разработчика, вам потребуется добавить параметр в свойство Extensibility Configurations вашего модуля OutSystems:

{
  "preferences": {
    "global": [
      {
        "name": "aps-environment",
        "value": "development"
      }
    ]
  }
}

Этот параметр будет добавлен в ваш файл entitlements (узнайте больше о entitlements в документации для разработчиков Apple).

Если вы генерируете мобильное приложение для iOS с использованием производственного сертификата, вам не потребуется указывать какие-либо параметры, так как значение по умолчанию для параметра aps-environment в OutSystems — production.

Теперь ваше приложение готово к получению push-уведомлений. Настройте и сгенерируйте ваше мобильное приложение и установите его на свое устройство. На этом этапе вы можете использовать интерфейс Pushwoosh для отправки уведомлений в ваше приложение и убедиться, что все настроено правильно. Обратите внимание, что вы не увидите уведомление, если приложение запущено. Вместо этого немедленно вызывается событие NotificationReceivedEvent.

Отправка уведомлений

Для отправки уведомлений вам понадобится API Access Token Pushwoosh. Создайте его, зайдя в консоль Pushwoosh, перейдите в «API Access» и нажмите «Generate new access token».

Чтобы отправить уведомление на все устройства, используйте действие SendPushNotificationToAll.

Это действие принимает следующие параметры:

• PushwooshApplicationCode: Код Pushwoosh, который вы получили после создания приложения в Pushwoosh.
• ApiAccessToken: Токен доступа API Pushwoosh, полученный ранее.
• Message: Текст сообщения, которое вы хотите отправить.
• Badge: Число, которое отображается на иконке приложения iOS.
• Deeplink: Deep link для отправки с уведомлением. Узнайте, как определять deep links.

Например, если вы используете это действие для отправки сообщения «Hello from OutSystems» в приложение под названием «PushTest», на iOS будет показано следующее:

Дополнительная информация

• Если ваше приложение запущено, уведомление не отображается на устройстве. Вместо этого оно отправляется в приложение, и вызывается событие NotificationReceivedEvent. Вам нужно будет определить, что приложение должно делать в этой ситуации.
• Push-уведомления могут активироваться не сразу. Если вы не видите поступающих уведомлений, подождите несколько минут, прежде чем приступать к дальнейшему поиску неисправностей.

Поделитесь с нами своим мнением

Ваши отзывы помогают нам улучшать наш продукт, поэтому мы будем рады, если вы поделитесь с нами своим мнением о процессе интеграции SDK. Если вы столкнетесь с какими-либо трудностями, пожалуйста, не стесняйтесь поделиться своими мыслями с нами через эту форму.