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

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

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

Чтобы интегрировать Wavesend Flutter 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.

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

# Клонируйте репозиторий SDK и перейдите к примеру проекта
git clone https://github.com/Wavesend/wavesend-flutter

# Перейдите в каталог example
cd wavesend-flutter/Source/wavesend/example

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

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

flutter pub get

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

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

Замените значения app_id и sender_id на ваш Wavesend Application 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.wavesend)
• NotificationService: имя пакета вашего приложения с .NotificationServiceExtension (например, com.example.wavesend.NotificationServiceExtension)
• StopwatchWidgetExtension: имя пакета вашего приложения с .StopwatchWidget (например, com.example.wavesend.StopwatchWidget)

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

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

Android

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

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

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.wavesend.apitoken" android:value="__YOUR_WAVESEND_DEVICE_API_TOKEN__" />

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

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

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

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

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