Outsystems

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

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

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

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

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. Имя пакета (package name) из сервисов 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 с использованием производственного сертификата (production certificate), вам не нужно указывать никаких параметров, поскольку значением по умолчанию для aps-environment в OutSystems является production.

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

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

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

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

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

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

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

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