更新记录

1.0.1（2026-01-11）

适用于uniapp项目的uts插件。

平台兼容性

uni-app(4.86)

其他

sdkj-fcmtoken

Android Google FCM 推送插件 (UTS版本适用于uniapp项目)。 支持获取 Token、监听 Token 刷新、前台/后台消息接收、自动显示通知。

环境要求

• HBuilderX 3.9+ (支持 UTS)
• Android 5.0+ (API 21)
• 必须使用自定义基座运行

准备工作

1. 将 google-services.json 文件放入nativeResources/android/google-services.json（nativeResources与 manifest.json 同级）。
2. 在 uni_modules/sdkj-fcmtoken/utssdk/app-android/res/drawable/ 下放入通知图标 push_icon.png (推荐白色透明底图)。

使用方法

1. 引入插件

import { initFCM, getFCMToken, onMessageReceived, onTokenRefresh } from "@/uni_modules/sdkj-fcmtoken";

// 1. 初始化 FCM
initFCM({
    success: (res) => {
        console.log("FCM 初始化成功");

        // 2. 监听消息 (前台/后台运行)
        onMessageReceived((msg) => {
            console.log("收到消息:", msg.title, msg.body);
        });

        // 3. 监听 Token 刷新 (建议同步给后端)
        onTokenRefresh((newToken) => {
            console.log("Token 刷新:", newToken);
            // TODO: 调用后端 API 更新 Token
        });

        // 4. 主动获取 Token (首次或冷启动)
        getFCMToken({
            success: (t) => {
                console.log("当前 Token:", t.token);
                // TODO: 存入服务器
            },
            fail: (e) => console.error("获取Token失败:", e.errMsg)
        });
    },
    fail: (err) => {
        console.error("FCM 初始化失败，请检查 google-services.json", err);
    }
});

// 5. Android 13+ 动态申请通知权限 (必须)
// #ifdef APP-PLUS
if (plus.os.name == 'Android' && plus.android.runtimeMainActivity()) {
    // 自行实现权限请求逻辑...
}
// #endif