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

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

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

Для интеграции Pushwoosh Flutter 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-flutter

# Перейдите в директорию примера
cd pushwoosh-flutter/Source/pushwoosh/example

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

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

flutter pub get

Откройте файл lib/main.dart и обновите вызов Pushwoosh.initialize:

Pushwoosh.initialize({"app_id": "XXXXX-XXXXX", "sender_id": "XXXXXXXXXXXX"});

Замените значения app_id и sender_id на ваш Pushwoosh App Code и Firebase Project Number.

iOS

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

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

cd ios && pod install --repo-update

2. Установка Bundle Identifier

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

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

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

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>:

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

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

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

Соберите и запустите проект.
Приложение будет иметь две вкладки: “Actions” и “Settings”. Перейдите на вкладку Settings.
Нажмите кнопку Register for Pushes.
Предоставьте разрешение на push-уведомления. Устройство будет зарегистрировано в Pushwoosh.

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

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