Flutter推送服务插件flutter_huaji_push的使用

Flutter推送服务插件flutter_huaji_push的使用

安装

在工程 pubspec.yaml 中加入依赖：

dependencies:
  flutter_huaji_push: 1.1.3

集群域名配置（如果您的应用非广州集群请按照以下方法进行域名配置，广州集群请忽略）

集群域名：

• 中国上海：tpns.sh.tencent.com
• 中国香港：tpns.hk.tencent.com
• 新加坡：tpns.sgp.tencent.com

iOS端需要在注册方法startXg之前调用以下域名配置函数

void configureClusterDomainName(String domainStr);

Android端需要在Manifest文件application标签内添加以下元数据：

<application>
    <!-- 其他安卓组件 -->
    <meta-data
        android:name="XG_SERVER_SUFFIX"
        android:value="其他地区域名" />
</application>

iOS

在Xcode8之后需要点开推送选项：

TARGETS -> Capabilities -> Push Notification 设为on状态

Android

1. 环境配置

在build.gradle文件中添加以下配置：

android: {
    ....
    defaultConfig {
        applicationId "替换成自己应用ID"
        ...
        ndk {
            /// 选择要添加的对应.so库。
            abiFilters 'armeabi', 'armeabi-v7a', 'x86', 'x86_64', 'mips', 'mips64', 'arm64-v8a',
        }
        //
        manifestPlaceholders = [
            XG_ACCESS_ID : "替换自己的ACCESS_ID",  // 信鸽官网注册所得ACCESS_ID
            XG_ACCESS_KEY : "替换自己的ACCESS_KEY",  // 信鸽官网注册所得ACCESS_KEY
        ]
    }
}

2. 代码混淆

在proguard-rules.pro文件中添加以下规则：

-keep public class * extends android.app.Service
-keep public class * extends android.content.BroadcastReceiver
-keep class com.tencent.android.tpush.** {*;}
-keep class com.tencent.tpns.baseapi.** {*;}
-keep class com.tencent.tpns.mqttchannel.** {*;}
-keep class com.tencent.tpns.dataacquisition.** {*;}

-keep class com.tencent.bigdata.baseapi.** {*;}   // TPNS-Android-SDK 1.2.0.1及以上版本不需要此条配置
-keep class com.tencent.bigdata.mqttchannel.** {*;}  // TPNS-Android-SDK 1.2.0.1及以上版本不需要此条配置

3. 厂商通道接入说明

提供了安卓各厂商通道接入方法。

点击查看

APIs

提供了TPNS的所有业务接口。

点击查看

TPNS-Flutter 使用常见问题参考

点击查看

完整示例Demo

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

import 'package:flutter/services.dart';
import 'package:flutter_huaji_push/flutter_huaji_push.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';

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

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    String platformVersion;
    // 平台消息可能会失败，所以我们使用try/catch处理PlatformException。
    try {
      platformVersion = await FlutterHuajiPush.xgSdkVersion;
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果小部件从树中移除时异步平台消息还在飞行中，我们想丢弃回复而不是调用setState来更新我们的不存在的外观。
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('运行于: $_platformVersion\n'),
        ),
      ),
    );
  }
}