Flutter消息推送插件push_express_lib的使用

本指南将指导你如何在应用程序中集成PushExpressLib，并处理应用处于前台和后台状态时的消息推送。

开始

首先，在你的main.dart文件中导入该包：

import 'package:push_express_lib/push_express_lib.dart';

然后，你可以在代码中使用该包的功能。

指导

第一步

初始化包

void initFirebase() async {
    // 初始化Firebase应用
    await Firebase.initializeApp(
        options: DefaultFirebaseOptions.currentPlatform,
    );

    // 请求推送通知权限
    await FirebaseMessaging.instance.requestPermission();

    // 获取唯一的FCM令牌
    String? token = await FirebaseMessaging.instance.getToken();

    if (token != null) {
        // 初始化包
        PushExpressManager().init(
            // 从https://app.push.express/获取你的应用ID
            '21486-1212',
            TransportType.fcmData,
            transportToken: token,
            // 如果需要在应用处于前台时接收通知（仅限iOS），设置foreground为true
            foreground: true,
        );
    }
}

[@override](/user/override)
void initState() {
    super.initState();

    // 调用初始化函数
    initFirebase();
}

第二步

启用后台消息处理

Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  // 初始化Firebase应用
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );

  // 调用包中的函数来处理通知，并在后台正确显示它们
  NotificationManager().handleNotification(message);
}

void main() {
  // 确保小部件已初始化
  WidgetsFlutterBinding.ensureInitialized();

  // 处理Firebase后台消息
  // 并调用我们的处理器
  FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);

  runApp(const MyApp());
}

第三步（可选）

处理前台消息

// 如果你想在应用处于前台时接收任何推送通知
// 在你的代码中添加以下行
FirebaseMessaging.onMessage.listen(
    // 提供此函数以正确处理通知并显示它们
    NotificationManager().handleNotification,
);

示例

以下是帮助你开始的一些示例代码：

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';
import 'package:flutter/material.dart';
import 'package:flutter_test_package/firebase_options.dart';
import 'package:push_express_lib/enums/common.dart';
import 'package:push_express_lib/notification_manager.dart';
import 'package:push_express_lib/push_express_lib.dart';

Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  NotificationManager().handleNotification(message);
}

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
    initFirebase();
  }

  void initFirebase() async {
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );

    await FirebaseMessaging.instance.requestPermission();

    String? token = await FirebaseMessaging.instance.getToken();

    if (token != null) {
      PushExpressManager().init(
        '21486-1212',
        TransportType.fcm,
        transportToken: token,
        foreground: true,
      );
    }

    FirebaseMessaging.onMessage.listen(
      NotificationManager().handleNotification,
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              '你已经点击了按钮这么多次:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: '增加',
        child: const Icon(Icons.add),
      ),
    );
  }
}