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

Начните работу с Wavesend Cordova SDK с помощью этого простого и быстрого примера.

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

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

Requirements

• A Wavesend account.
• A Wavesend project set up in your account.
• For iOS integration:
  • An iOS platform configured to send push notifications. We recommend using the Token-Based Authentication configuration as the simplest approach.
  • During setup, set the Gateway to Sandbox to send pushes to a simulator.
• For Android integration:
  • A configured Android platform
  • The project number(also known as Sender ID) , google-services.json file and package name from your Firebase project.
  • A Firebase project connected to your Android application. Follow the Firebase setup guide if needed.
• Your Wavesend Application Code and Wavesend Device API Token from the Wavesend Control Panel for your application.

Загрузка примера проекта

# Clone the SDK repository and navigate to the example project
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# Navigate to example directory
cd pushwoosh-phonegap-plugin/example/newdemo/

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

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

npm i

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

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

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

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

Замените значения appid и projectid на ваш Application code Wavesend и номер проекта Firebase.

iOS

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

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

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

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

2. Добавьте capabilities

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

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

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

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

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

Android

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

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

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

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

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

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

AndroidManifest.xml

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

Замените __YOUR_PUSHWOOSH_DEVICE_API_TOKEN__ на ваш Wavesend Device API Token.

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

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

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

Вернитесь в Wavesend Control Panel и отправьте push-уведомление на ваше зарегистрированное устройство.