Краткое руководство по React Native SDK

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

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

Для интеграции Pushwoosh React Native 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-react-native-plugin.git

# Перейдите в директорию example
cd pushwoosh-react-native-plugin/example/demoapp/

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

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

npm install

Откройте Settings.js и обновите вызов Pushwoosh.init:

Pushwoosh.init({ "pw_appid" : "__YOUR_APP_ID__" });

Замените __YOUR_APP_ID__ на ваш код приложения Pushwoosh.

iOS

1. Установите зависимости

Перейдите в директорию ios и установите зависимости:

cd ios && pod install --repo-update

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

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

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

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

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

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

Android

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

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

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="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

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

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

1. Соберите и запустите проект.
2. В приложении будет две вкладки: «Actions» и «Settings». Перейдите на вкладку Settings.
3. Нажмите кнопку Register for Push Notifications.
4. Предоставьте разрешение на получение push-уведомлений. Устройство будет зарегистрировано в Pushwoosh.

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

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