Конфигурация SDK

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

• В Flutter-проект добавлен пакет altcraft_sdk.
• SDK провайдеров push-уведомлений интегрированы в проект приложения.
• Для Android настроен один или несколько провайдеров: FCM, HMS, RuStore.
• Для iOS настроен один или несколько провайдеров: APNS, FCM, HMS.
• Если API-запросы должны авторизоваться через JWT, JWT-провайдер зарегистрирован на нативной стороне приложения.

flutter pub add altcraft_sdk
flutter pub get

---

Подготовка приложения

Передача JWT-токена в SDK (опционально)

Реализация JWT требуется, если используется JWT-аутентификация API-запросов. JWT подтверждает, что пользовательские идентификаторы аутентифицированы приложением.

Реализация JWT-аутентификации обязательна, если используется тип матчинга, отличный от push-данных из подписки, например email, телефон или внутренний идентификатор пользователя.

В Flutter SDK JWT-провайдер не регистрируется через Dart API. Его необходимо настроить нативно:

• Android: в Application.onCreate;
• iOS: в AppDelegate.

Настройка выполняется аналогично нативным SDK платформ: Android и iOS.

---

Подготовка к работе с push-провайдерами

Настройка push-провайдеров выполняется на нативной стороне приложения.

Android:

• Подключение FCM
• Подключение HMS
• Подключение RuStore
• Передача push-уведомлений в SDK

iOS:

• Подключение APNS
• Подключение FCM
• Подключение HMS
• Настройка AppDelegate
• Подготовка NSE

Важно

Flutter-пакет предоставляет Dart API и платформенный bridge. Регистрация JWT, push-провайдеров, обработка APNS/FCM/HMS/RuStore и настройка Notification Service Extension выполняются в нативных частях проекта.

---

Инициализация SDK

Параметры инициализации

Для передачи параметров конфигурации используется объект AltcraftConfig:

const AltcraftConfig(
  apiUrl: 'https://pxl-example.altcraft.com',
  appInfo: AppInfo(
    appID: '1:000000000000:android:0000000000000000',
    appIID: '00000000-0000-4000-8000-000000000000',
    appVer: '1.0.0',
  ),
  providerPriorityList: ['android-firebase'],
)

Описание параметров:

apiUrl String
Обязательный: Да
Описание: URL конечной точки Altcraft API.

---

appInfo AppInfo?
По умолчанию: null
Обязательный: Нет
Описание: Базовые метаданные приложения.

Поля AppInfo:

Поле	Тип	Описание
appID	String	Идентификатор приложения.
appIID	String	Идентификатор установки приложения.
appVer	String	Версия приложения.

---

providerPriorityList List<String>?
По умолчанию: null
Обязательный: Нет
Описание: Список приоритетов push-провайдеров. Индекс 0 — самый приоритетный провайдер.

Пример для Android:

providerPriorityList: ['android-firebase', 'android-huawei', 'android-rustore']

Пример для iOS:

providerPriorityList: ['ios-apns', 'ios-firebase', 'ios-huawei']

---

Выполнение инициализации

Для инициализации SDK используйте функцию initialize(config):

import 'package:altcraft_sdk/altcraft_sdk.dart';
import 'package:flutter/widgets.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await AltcraftSDK.initialize(
    const AltcraftConfig(
      apiUrl: 'https://pxl-example.altcraft.com',
      appInfo: AppInfo(
        appID: '1:000000000000:ios:0000000000000000',
        appIID: '00000000-0000-4000-8000-000000000001',
        appVer: '1.0.0',
      ),
      providerPriorityList: ['ios-apns'],
    ),
  );

  runApp(const AppRoot());
}

class AppRoot extends StatelessWidget {
  const AppRoot({super.key});

  @override
  Widget build(BuildContext context) {
    return const Directionality(
      textDirection: TextDirection.ltr,
      child: SizedBox.shrink(),
    );
  }
}

---

Работа с App Group и UserDefaults на iOS

Для iOS SDK предоставляет методы для установки App Group и записи значений в UserDefaults.

import 'dart:io';

import 'package:altcraft_sdk/altcraft_sdk.dart';

void configureIosAppGroup() {
  if (!Platform.isIOS) return;

  const String appGroup = 'group.altcraft.flutter.example';

  AltcraftSDK.setAppGroup(appGroup);
  AltcraftSDK.setUserDefaultsValue(
    appGroup,
    'altcraft_jwt',
    'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtYXRjaGluZyI6ImVtYWlsIn0.signature',
  );
}

Метод setUserDefaultsValue() также доступен на Android, где значение сохраняется в SharedPreferences.

---

Запрос разрешения на уведомления

Для Android используйте requestNotificationPermission():

import 'package:altcraft_sdk/altcraft_sdk.dart';

Future<bool> requestAndroidNotificationPermission() {
  return AltcraftSDK.requestNotificationPermission();
}

Метод возвращает true, если разрешение предоставлено, и false, если пользователь отказал.