Быстрый старт с 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

# Перейдите в директорию example
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 для каждой цели (target):

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-уведомление на ваше зарегистрированное устройство.