qidao123.com技术社区-IT企服评测·应用市场

标题: 实战｜使用环信Flutter SDK构建鸿蒙HarmonyOS应用及推送配置 [打印本页]
作者: 王國慶    时间: 2025-4-22 18:53
标题: 实战｜使用环信Flutter SDK构建鸿蒙HarmonyOS应用及推送配置
本文为各人介绍如何在 Flutter 环境创建 Harmony 项目并集成环信即时通讯IM以及环信 Flutter Harmony 推送配置。
已经基于环信的 Flutter 项目也可以参考本文适配鸿蒙端。
一、开发环境要求

前置条件

1.安装DevEco-Studio
2.安装模仿器
DevEco-Studio 下载与操纵引导：
oh环境变量

  1. export TOOL_HOME=/Applications/DevEco-Studio.app/Contents # mac环境
  2. export DEVECO_SDK_HOME=$TOOL_HOME/sdk # command-line-tools/sdk
  3. export PATH=$TOOL_HOME/tools/ohpm/bin:$PATH # command-line-tools/ohpm/bin
  4. export PATH=$TOOL_HOME/tools/hvigor/bin:$PATH # command-line-tools/hvigor/bin
  5. export PATH=$TOOL_HOME/tools/node/bin:$PATH # command-line-tools/tool/node/bin
复制代码
Flutter 环境变量

  1. export PATH="$HOME/Settings/flutter/bin:$PATH"
复制代码
环境验证

  1. flutter doctor
复制代码
乐成效果

  1. [!] Flutter (Channel oh-3.22.0, 3.22.1-0.0.pre.32, on macOS 14.5 23F79
  2.     darwin-arm64, locale zh-Hans-CN)
  3.     ! Upstream repository git@gitee.com:harmonycommando_flutter/flutter.git is
  4.       not a standard remote.
  5.       Set environment variable "FLUTTER_GIT_URL" to
  6.       git@gitee.com:harmonycommando_flutter/flutter.git to dismiss this error.
  7. [✓] HarmonyOS toolchain - develop for HarmonyOS devices
  8. [✓] Android toolchain - develop for Android devices (Android SDK version 35.0.0)
  9. [✓] Xcode - develop for iOS and macOS (Xcode 16.0)
  10. [✓] Chrome - develop for the web
  11. [✓] Android Studio (version 2024.1)
  12. [✓] VS Code (version 1.97.2)
复制代码
至此说明环境已经搭建乐成
二、鸿蒙im_flutter_sdk快速入门

向已存在的项目中添加鸿蒙支持

需要先辈入到项目中，之后执行命令
  1. flutter create  --platforms=ohos .
复制代码
注意：后面有.
如果之前设置了org，此时大概会报org冲突，此时需要在命令中指定 org。
  1. flutter create  --platforms=ohos .
  2. --org="xxx.xxx"
复制代码
此中 xxx.xxx 为您 org 的名称。
新建支持鸿蒙的项目

  1. flutter create new_project_name --org="xxx.xxx" --platforms=ios,android,ohos
复制代码
添加 im_flutter_sdk

自 SDK 4.13.0 开始支持鸿蒙。若要在鸿蒙平台使用，需举行以下配置：
1、使用支持鸿蒙的 Flutter，详情请参见相关文档。
2、在工程的 pubspec.yaml 中添加 sdk 依赖。或在环信官网下载IM Flutter SDK
  1. im_flutter_sdk: ^4.13.0
  2. im_flutter_sdk_ohos:
  3.   git:
  4.     url: "https://github.com/easemob/im_flutter_sdk_oh.git"
  5.     ref: 1.5.3
复制代码
修改 useNormalizedOHMUrl 模式

因为 环信 sdk 只支持 useNormalizedOHMUrl模式，需要在你的项目中配置 useNormalizedOHMUrl 为 true
打开 app/ohos/build-profile.json5 文件，找到 app:products:, 并向此中添加 buildOption
  1. "products": [
  2.   {
  3.     "name": "default",
  4.     "signingConfig": "default",
  5.     "compatibleSdkVersion": "5.0.0(12)",
  6.     "runtimeOS": "HarmonyOS",
  7.     // 添加内容
  8.     "buildOption": {
  9.       "strictMode": {
  10.         "useNormalizedOHMUrl": true
  11.       }
  12.     }
  13.   }
  14. ]
复制代码
运行项目时需要先 build hap包。 执行
  1. flutter build hap --debug
复制代码
注意：使用Visual studio code 大概会出现识别不到harmony 模仿器的环境
进入项目运行
  1. flutter run
复制代码
选择要执行的装备
  1. [1]: sdk gphone64 arm64 (emulator-5556)
  2. [2]: iPhone 15 Pro (99ECBD72-FCB5-4FD1-ADC8-0E0D52AE9B70)
  3. [3]: Mac Designed for iPad (mac-designed-for-ipad)
  4. Please choose one (or "q" to quit):
复制代码
至此乐成集成了环信Flutter Harmony
三、推送配置

在Flutter层初始化的时候举行配置AppID

  1. EMOptions options = EMOptions.withAppKey(
  2.       "appkey",
  3.       extSettings: {
  4.         ExtSettings.kAppIDForOhOS: "appid",
  5.       },
  7.     );
复制代码
harmony 检查包名是否与开放平台一致
  1. project--->AppScope--->appjson5--->bundleName
复制代码
手动署名

手动署名参考华为开发文档
手动配置署名信息

1、点击DevEco Studio右上角的File 打开Project Structure窗口，进入Signing Config页签，取消勾选Automatically generate signature。
在Signing下分别配置密钥(.p12文件)、Profile(.p7b文件)和数字证书(.cer文件)的路径等信息。
2、勾选Show restricted permissions，即可看到配置乐成的权限。
3、配置完毕后，点击Apply。
4、进入工程级build-profile.json5文件，在signingConfigs下可检察到配置乐成的署名信息，点击右上角的Run按钮运行应用/元服务。
至此，我们完成了环信Flutter Harmony 集成与推送。通过本次环信Flutter Harmony项目标实践，我们不仅掌握了在Flutter环境下创建鸿蒙项目标根本流程，还深入相识了环信推送在鸿蒙系统上的配置与应用，这是一次富有挑战性和劳绩性的探索之旅。
资助文档：



免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。



欢迎光临 qidao123.com技术社区-IT企服评测·应用市场 (https://dis.qidao123.com/) Powered by Discuz! X3.4