Flutter功能未定义插件fyno_flutter的使用

Fyno的Flutter推送通知SDK为您的应用程序提供了全面的通知功能。它旨在高效地传递消息，确保最佳性能和用户体验。

前置条件

在开始之前，需要满足一些前提条件：

1. Fyno账户：有效的Fyno工作区，至少有一个活动的API密钥。更多信息请参阅Workspace Docs。
2. 配置：在Fyno App中配置您的Fyno推送提供商。
3. Flutter应用程序：您希望集成SDK的工作Flutter应用程序。
4. iOS特定前置条件：
   • Apple开发者账户：所需详情请参阅APNs Docs。
5. Android特定前置条件：
   • Firebase设置：设置Firebase并在Firebase控制台中创建应用程序。您可以参考FCM Documentation获取更多详细信息。
   • 小米设置：设置小米开发者账户并在小米推送控制台中创建应用程序。您可以参考Mi Push Documentation获取更多详细信息。
   • 从Firebase控制台下载google-services.json并将其放置在根文件夹中，具体操作请参阅FCM Documentations。

安装

使用以下命令之一安装fyno_flutter包：

dart pub add fyno_flutter

或者

flutter pub add fyno_flutter

这将在您的包的pubspec.yaml文件中添加以下依赖项（并隐式运行dart/flutter pub get）：

dependencies:
  fyno_flutter: <latest_version>

或者，您的编辑器可能支持dart pub get或flutter pub get。请查阅编辑器文档以了解更多信息。

使用

在您打算初始化SDK的Dart文件中，通过包含以下导入语句无缝集成fyno_flutter包：

import 'package:fyno_flutter/fyno_flutter.dart';

初始化SDK（应在应用程序启动时调用）

• Workspace ID（必填）：您将在Workspace Settings页面顶部看到的唯一Workspace ID。
• Integration ID（必填）：在Fyno Integrations中创建的集成ID。
• Distinct ID（可选）：用户的唯一标识符（如果没有传递值，则自动生成一个UUID）。
• Version（可选）：指示用户创建的环境，可以是“test”或“live”。（默认值是“live”）。

Future<Exception?> initException = await FynoFlutter.init(
  "workspace_id",
  "integration_id",
  "distinct_id",
  "version",
);

if (initException == null) {
  // Initialization successful
} else {
  // Handle initialization error
  print("Initialization error: $initException");
}

示例Demo

以下是一个完整的示例演示如何初始化、识别用户以及注册推送通知：

import 'package:flutter/material.dart';
import 'package:fyno_flutter/fyno_flutter.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化SDK
  Future<Exception?> initException = await FynoFlutter.init(
    "your_workspace_id",
    "your_integration_id",
    "optional_distinct_id",
    "live", // or "test"
  );

  if (initException == null) {
    print("Initialization successful");
  } else {
    print("Initialization error: $initException");
  }

  // 识别用户
  Future<Exception?> identifyException = await FynoFlutter.identify("new_distinct_id", "user_name");

  if (identifyException == null) {
    print("User identification successful");
  } else {
    print("Identification error: $identifyException");
  }

  // 注册推送通知（使用APNs）
  Future<Exception?> apnsPushRegistrationException = await FynoFlutter.registerPush(
    "apns",
  );

  if (apnsPushRegistrationException == null) {
    print("Push registration successful");
  } else {
    print("Push registration error: $apnsPushRegistrationException");
  }

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Fyno Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Scaffold(
        appBar: AppBar(
          title: Text('Fyno Flutter Demo'),
        ),
        body: Center(
          child: Text('Check console for initialization and push registration status.'),
        ),
      ),
    );
  }
}

iOS配置步骤

为了使iOS设备能够接收推送通知，还需要进行以下配置步骤：

第一步：在iOS应用程序中添加功能

1. 在Targets中选择Signing & Capabilities。
2. 单击+Capabilities并添加Push Notifications和Background Modes功能到您的应用程序。

1. 在Background Modes中选择Remote Notifications选项。我们使用后台通知来接收当您的应用程序处于退出和后台状态时的交付报告。有关背景通知的更多信息，请参阅doc。

第二步：在AppDelegate.swift文件中注册推送通知

1. 在您的AppDelegate.swift文件中添加以下代码：

// without FCM

import UIKit
import Flutter
import fyno_push_ios

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    let fynosdk = fyno.app

    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        GeneratedPluginRegistrant.register(with: self)

        UNUserNotificationCenter.current().delegate = fynosdk

        self.fynosdk.registerForRemoteNotifications()
        fynosdk.requestNotificationAuthorization{ _ in}

        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }

    override func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
        print("Failed to register for remote notifications: \(error.localizedDescription)")
    }

    override func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        // Send the device token to fynoServer
        fynosdk.setdeviceToken(deviceToken: deviceToken)
    }
}

如果您集成了FCM，还需要添加以下代码：

// with FCM

import UIKit
import Flutter
import fyno_push_ios

// imports required for FCM integration
import FirebaseCore
import FirebaseMessaging

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    let fynosdk = fyno.app

    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        GeneratedPluginRegistrant.register(with: self)

        UNUserNotificationCenter.current().delegate = fynosdk

        self.fynosdk.registerForRemoteNotifications()

        FirebaseApp.configure() // add only if FCM has been integrated

        fynosdk.requestNotificationAuthorization {_ in}

        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }

    override func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
        print("Failed to register for remote notifications: \(error.localizedDescription)")
    }

    override func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        // Send the device token to fynoServer
        fynosdk.setdeviceToken(deviceToken: deviceToken)

        Messaging.messaging().apnsToken = deviceToken // add only if FCM has been integrated
    }
}

添加通知服务扩展到您的应用程序

1. 在Xcode中，转到File > New > Target。
2. 从模板列表中选择Notification Service Extension。
3. 然后在下一个弹出窗口中给它任何产品名称，选择您的团队，选择Swift语言并点击完成。

1. 单击“Finish”后，将创建一个带有您给定产品名称的文件夹。将NotificationService.swift文件的内容替换为以下代码：

import UserNotifications
import UIKit
import fyno

class NotificationService: UNNotificationServiceExtension {
    var contentHandler: ((UNNotificationContent) -> Void)?
    var bestAttemptContent: UNMutableNotificationContent?

    override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        fyno.app.handleDidReceive(request, withContentHandler: contentHandler)
    }

    override func serviceExtensionTimeWillExpire() {
        if let contentHandler = contentHandler, let bestAttemptContent =  bestAttemptContent {
            contentHandler(bestAttemptContent)
        }
    }
}