Быстрый старт с Cordova SDK

Начните работу с Pushwoosh Cordova SDK, используя этот быстрый и простой пример.

Предварительные требования

Для интеграции Pushwoosh Cordova SDK в ваше приложение вам понадобится следующее:

Требования

• Аккаунт Pushwoosh.
• Проект Pushwoosh, настроенный в вашем аккаунте.
• Для интеграции с iOS:
  • Платформа iOS, настроенная для отправки push-уведомлений. Мы рекомендуем использовать конфигурацию на основе токенов (Token-Based Authentication) как самый простой подход.
  • Во время настройки установите Gateway в значение Sandbox, чтобы отправлять пуши на симулятор.
• Для интеграции с Android:
  • Настроенная платформа Android
  • project number (также известный как Sender ID), файл google-services.json и package name из вашего проекта Firebase.
  • Проект Firebase, подключенный к вашему Android-приложению. При необходимости следуйте руководству по настройке Firebase.
• Ваш Pushwoosh Application Code и Pushwoosh Device API Token из Pushwoosh Control Panel для вашего приложения.

Скачайте пример проекта

# Клонируйте репозиторий SDK и перейдите в папку с примером проекта
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# Перейдите в папку с примером
cd pushwoosh-phonegap-plugin/example/newdemo/

Настройте проект

Установите зависимости:

npm i

Добавьте плагин Pushwoosh:

cordova plugin add ../../ --link --nofetch

Откройте www/js/index.js и обновите вызов pushwoosh.onDeviceReady:

pushwoosh.onDeviceReady({
    appid: "XXXXX-XXXXX",
    projectid: "XXXXXXXXXXXXXXX"
});

Замените значения appid и projectid на ваш код приложения Pushwoosh и номер проекта Firebase.

iOS

1. Установите Bundle Identifier

Откройте файл platforms/ios/newdemo.xcworkspace в Xcode.

Установите Bundle Identifier для каждой цели (target):

• newdemo: имя пакета вашего приложения. (например, com.example.pushwoosh)

2. Добавьте capabilities

Чтобы включить push-уведомления, вам нужно добавить определенные capabilities.

В разделе Signing & Capabilities добавьте следующие capabilities:

• Push Notifications
• Background Modes. После добавления этой capability, отметьте флажок Remote notifications.

3. Установите API Token

В вашем файле ios/newdemo/Info.plist установите для ключа Pushwoosh_API_TOKEN значение Pushwoosh Device API Token

Android

1. Настройте google-services.json

Скопируйте ваш файл google-services.json в корневую директорию проекта.

2. Установите имя пакета

Откройте android/app/build.gradle и установите applicationId на имя пакета вашего приложения (например, com.example.pushwoosh).

3. Установите API Token

Откройте ваш файл android/app/src/main/AndroidManifest.xml и добавьте следующие метаданные внутрь тега <application>:

AndroidManifest.xml

<meta-data android:name="com.pushwoosh.apitoken" android:value="__ВАШ_PUSHWOOSH_DEVICE_API_TOKEN__" />

Замените __ВАШ_PUSHWOOSH_DEVICE_API_TOKEN__ на ваш Pushwoosh Device API Token.

Запустите проект

1. Соберите и запустите проект.
2. Переключите переключатель Register for notifications.
3. Предоставьте разрешение на push-уведомления. Устройство будет зарегистрировано в Pushwoosh.

Отправьте push-уведомление

Вернитесь в Панель управления Pushwoosh и отправьте push-уведомление на ваше зарегистрированное устройство.