umeng_common_sdk_ohos —— 鸿蒙端友盟统计无缝接入

移动应用上线后，数据分析和用户行为统计是必不可少的一环。友盟（Umeng）作为国内最主流的三方统计平台之一，应该是很多 Flutter 开发者的首选。那么问题来了——鸿蒙平台能用友盟吗？

答案是：当然可以！ 来看今天的插件：umeng_common_sdk_ohos ✨

插件简介

umeng_common_sdk_ohos 是由 HarmonyCandies^[1] 社区出品的，将 umeng_common_sdk 适配到 OpenHarmony 平台的实现包。

一句话：Android/iOS 上怎么用友盟，鸿蒙上就怎么用。

当前版本 ^1.2.9 已在 pub.dev 发布，完美对齐主包 API。

核心特性

• ✅ 支持友盟 SDK 初始化 — initCommon
• ✅ 支持自定义事件追踪 — onEvent
• ✅ 支持用户账号登入/登出 — onProfileSignIn / onProfileSignOff
• ✅ 与 umeng_common_sdk 主包 API 完全一致
• ✅ 代码零改动，一行代码迁移

快速集成

1. 添加依赖

在 pubspec.yaml 中：

dependencies:
  umeng_common_sdk: 1.2.8       # 主包，提供统一 API
  umeng_common_sdk_ohos: 1.2.9  # 鸿蒙平台实现

flutter pub get

2. 添加配置文件

在项目的 AppScope/resources/rawfile 目录下新增 umconfig.json：

{
  "appKey": "你的友盟AppKey",
  "channel": "你的渠道名称"
}

⚠️ 虽然当前鸿蒙平台不使用 initCommon 传入的配置，但配置文件仍然必须存在。

3. 初始化 SDK

import 'package:umeng_common_sdk/umeng_common_sdk.dart';

// 初始化（Android/iOS 传入各自的 key，鸿蒙上以配置文件为准）
UmengCommonSdk.initCommon('android_key', 'ios_key', 'channel');

4. 上报事件

// 自定义事件
UmengCommonSdk.onEvent('event_id', {
  'key1': 'value1',
  'key2': 'value2',
});

// 用户登录
UmengCommonSdk.onProfileSignIn('user_id');

// 用户登出
UmengCommonSdk.onProfileSignOff();

注意事项

受限于鸿蒙友盟原生 SDK 的能力，当前版本支持的 API 有：

📢 如果你的应用需要更复杂的统计分析能力，可以持续关注该插件的版本更新。

适用场景

• Flutter 项目适配鸿蒙 OHOS 平台
• 需要接入友盟 U-App 统计分析
• 希望保持 Android/iOS/鸿蒙三端统一代码
• 不想额外引入其他分析 SDK，降低维护成本

关于本系列

「鸿蒙 Flutter 插件精选」 持续更新中，每期介绍一个优秀的鸿蒙 Flutter 适配插件，帮你高效完成鸿蒙迁移。如果你有推荐或踩过坑的插件，欢迎交流！

• 🔗 插件地址：https://pub.dev/packages/umeng_common_sdk_ohos^[2]
• 🐙 GitHub：https://github.com/harmonycandies/umeng_common_sdk_ohos^[3]

给个 ⭐ Star 支持一下 HarmonyCandies 社区吧～ 🦊

----------

引用链接