Flutter 三方库在 OHOS 平台的适配实践：以 flutter_test_lib 为例

最新推荐文章于 2025-12-18 21:03:42 发布

原创最新推荐文章于 2025-12-18 21:03:42 发布 · 199 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#鸿蒙 #ArkTS #Flutter #移动开发 #跨平台

鸿蒙开发同时被 2 个专栏收录

59 篇文章

订阅专栏

flutter

45 篇文章

订阅专栏

Flutter 三方库在 OHOS 平台的适配实践：以 flutter_test_lib 为例

引言

OpenHarmony（OHOS）作为新一代的智能终端操作系统，生态发展迅速，吸引了越来越多开发者的目光。对于那些已经拥有成熟 Flutter 应用的团队来说，将应用平滑地迁移到 OHOS 平台，无疑是拓展市场、拥抱鸿蒙生态的重要一步。

不过，迁移之路并非一片坦途。Flutter 丰富的三方插件生态，目前主要还是围绕着 Android 和 iOS 构建的，缺乏对 OHOS 的原生支持，这成了迁移过程中一个不小的技术挑战。

一、理解原理

1.1 Flutter 插件工作原理

Flutter 插件本质上是一个“翻译官”和“调度员”。它的核心是 Platform Channels（平台通道）这套通信机制。

1.2 针对 OHOS 的适配策略

既然 OHOS 不能直接运行 Android 或 iOS 的代码，我们的策略就很明确了：在 OHOS 这边，仿照原插件的功能，自己实现一个原生模块，并且注册一个同名同姓的 MethodChannel 来“冒名顶替”。

二、动手实践

2.1 准备环境

首先，确保你的基础环境是OK的。

2.2 实现 OHOS 原生模块

在 OHOS 模块的 entry/src/main/ets/ 目录下，新建一个类来处理 Flutter 端的调用。

三、总结

通过上面的实践，我们完整走通了一条 Flutter 三方插件适配 OHOS 的路径。整个过程的关键可以概括为：吃透原理、映射功能、实现通道、注册插件、联动调试。

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

kirk_wang

关注关注

2
点赞
踩
2

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

Flutter 应用热更新

xiangzhihong8的专栏

04-24

4284

Flutter 热更新简介所谓热更新，指的是当应用代码出现缺陷问题时，不需要重新打包提交App Store即可完成缺陷的修复。众所周知，使用原生技术开发的应用体验虽然好，但开发、上线周期长也常常被诟病，特别是当应用出现线上问题时，不得不重新打包发布，大大的影响了用户体验，而热更新技术就是为有效解决线上缺陷而提出的。不过，热更新虽然具有很大的优点，但是滥用热修复也会给应用带来不好的体验，并且苹果...

Flutter video_thumbnail 库在鸿蒙（OHOS）平台的适配实践

nanxuan521的专栏

12-15

1003

通过上面这个插件的适配案例，我们其实系统性地走了一遍将 Flutter 三方库迁移到鸿蒙平台的完整流程：从环境准备技术原理分析，到鸿蒙原生代码实现，再到集成调试与最后的性能优化。整个过程也再次印证了 Flutter 插件跨平台能力的本质——它通过一套标准化的通道协议，把具体的功能实现“委托”给了各个平台最擅长的原生部分。需要对Flutter 插件架构和OHOS Napi 开发模型都有比较深入的理解。要能精准找到功能对标的原生鸿蒙 API（比如这里的媒体解码和图像处理）。妥善处理异步和内存管理。

参与评论您还未登录，请先登录后发表或查看评论

Flutter 三方库在 OHOS 平台的适配实践：以 flutter_mailer 为例

nanxuan521的专栏

12-14

595

通过上面以为例的实践，我们完整走通了一条 Flutter 三方插件适配 OHOS 的路径。吃透原理、映射功能、实现通道、注册插件、联动调试。其核心思想是“接口不变，实现重写”。我们不需要（也不应该）去改动 Flutter 层现有的、经过验证的 Dart 业务代码，只需要在 OHOS 侧“冒充”原插件，提供一个符合约定的原生实现即可。看起来步骤不少，但一旦跑通一个，后续适配其他插件就会快很多，因为模式和套路是相似的。

ohos平台适配flutter三方库指导

黑马苏杰豪，华为HDE

04-04

955

flutter开发环境已配置：参考下载待适配的三方插件：官方插件库地址。

Flutter与鸿蒙三方库ohos的适配

flfljh的专栏

01-03

727

官网下载path_provider 2.1.0源码（https://pub-web.flutter-io.cn/packages/path_provider/versions/2.1.0）

Flutter_udid 三方库鸿蒙适配之旅：从零到一的深度实践

坚果的博客

06-29

852

开放匿名设备标识符（Open Anonymous Device Identifier, OAID，以下简称OAID）：是一种非永久性设备标识符，基于开放匿名设备标识符，OAID是基于华为自有算法生成的32位类UUID（Universally Unique Identifier）标识符，格式为xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

Flutter到鸿蒙的跨越：flutter_app_icon_badge库的鸿蒙适配之旅【上篇】

坚果的博客

06-29

640

本文介绍了将Flutter插件flutter_app_icon_badge适配到鸿蒙平台的完整过程。该插件用于更改应用程序图标上的角标功能，通过插件化适配器模式帮助开发者快速实现跨平台迁移。适配步骤包括：1)选择0.0.10版本为基础；2)创建鸿蒙模块并配置pubspec.yaml；3)编写ArkTS原生模块，参考鸿蒙API文档实现功能。最终在项目pubspec.yaml中添加git依赖即可使用。文章详细讲解了目录结构、环境配置、代码实现等关键环节，为Flutter开发者迁移到鸿蒙生态提供了实用指导。

Flutter 三方库 `flutter_phone_direct_caller` 在 OpenHarmony 平台的适配实战

nanxuan521的专栏

12-16

978

安装 Pigeon：在的下添加。创建协议文件：在项目根目录创建。// 配置 Pigeon 生成的文件路径和语言// OpenHarmony (ArkTS) 输出路径// 注意：目前 Pigeon 对 OHOS 的 ArkTS 支持还处于社区扩展阶段，可能需要使用特定版本或生成后手动调整。// 这里我们先生成接口定义，再手动编写 ArkTS 实现。),// 定义通信接口@HostApi()// 调起拨号界面，phoneNumber 为电话号码字符串// 返回布尔值表示是否成功发起意图。

从零到一：screenshot_callback库的鸿蒙适配深度探索

坚果的博客

06-29

700

本文介绍了如何将Flutter插件flutter_app_icon_badge适配到鸿蒙平台的过程。该插件用于管理应用图标角标，通过跨平台适配实现鸿蒙系统支持。文章详细讲解了适配步骤，包括版本选择、目录结构调整、创建鸿蒙模块、配置修改以及ArkTS代码编写。开发者可以通过修改pubspec.yaml添加依赖，并使用DevEco Studio完成原生模块开发。适配后的插件保留了原有功能，同时兼容鸿蒙系统API，为开发者提供无缝迁移体验。文末提供了完整的代码示例和API参考文档链接，帮助开发者快速实现角标管理功

Flutter 到 OpenHarmony,不是有手就行吗? (下拉刷新)

m0_70748458的博客

04-27

1033

五年前，有人告诉我，你可以错过其他技术，但千万不要错过Flutter。然而此刻，有人告诉我，如果你错过了 OpenHarmony，恐怕要错过下个时代了。作为发展了5年的 FlutterCandies 社区，我们已拥有70+的Flutter组件。我们当然也不会止步于Flutter。我们希望把我们的Flutter组件也能带到 OpenHarmony 生态当中，HarmonyCandies 便是为了这一刻。以Flutter开发者的角度，尽可能提供相同Api的 OpenHarmony 组件。

Android16 3576 u盘固件升级功能添加

tzj1058756809的博客

12-18

143

1.在u-boot/drivers/power/pmic/rk8xx.c。这里是读取power键的寄存器判断长短按。

Android 四大组件——Service(服务)【基础篇1】

最新发布

indeedes的博客

12-18

493

Android服务是四大组件之一，用于后台执行长时间运行操作，无用户界面。服务分为两种启动方式：StartService启动的服务独立运行，通过stopService停止；BindService启动的服务支持双向通信，所有客户端解绑后销毁。服务生命周期包含onCreate、onStartCommand、onBind等重要回调方法，其中onStartCommand的返回值和flags参数决定了服务被杀死后的恢复行为。关键区别在于服务是Android组件，比普通线程优先级更高，适合音乐播放、文件下载等后台任务。

【开题答辩实录分享】以《智慧酒店管理——手机预订和住宿管理》为例进行选题答辩实录分享

2509_93102599的博客

12-16

913

该系统基于Android平台开发，采用Java语言和MySQL数据库，服务器端使用B/S架构。系统主要分为两大功能模块：管理员模块包括个人信息管理、用户管理、客房类型管理、酒店客房管理、客房预订管理、入住登记管理和系统管理；用户模块支持查看客房信息、在线注册登录、一键预订、模拟支付、入住登记和个人信息管理。

Android-Audio-Usage 与 StreamType的区别

summerkissyou1987的专栏

12-15

475

维度StreamType (旧)AudioAttributes.Usage (新)引入时间Android 2.3 及更早设计理念基于播放流类型基于音频使用场景数量固定的 7-8 种类型灵活扩展，标准 10+ 种音量控制1:1 绑定到音量条可灵活映射到音量条优先级隐含在类型中显式优先级控制扩展性固定，不可扩展可自定义扩展推荐使用已废弃，仅兼容旧代码Android 5.0+ 推荐StreamType 是"流类型"思维，Usage 是"使用场景"思维StreamType。

Android学Dart学习笔记第十四节库和导库

weixin_44656996的博客

12-15

786

其他语言中的访问修饰符关键字提供了更细粒度的控制，而Dart使用下划线和基于库的隐私提供了直接的配置机制，有助于高效实现动态访问，并改进了树抖动（死代码消除）。库不仅提供api，还是隐私的单位：以下划线（_）开头的标识符只在库内部可见。当你导入的多个库中，使用了相同的类名时，可以为库起个别名，使用别名.类名明确指定所引用的类。使用import来指定如何在另一个库的作用域中使用来自一个库的命名空间。带有通配符_的导入前缀是不绑定的，但可以访问该库中的非私有扩展。

U+2011（Non-Breaking Hyphen）在UI测试中需要关注的问题

Criss@陈磊

12-16

U+2011（Non-Breaking Hyphen，非断行连字符）是一种Unicode字符，旨在防止在连字符处自动换行，主要用于排版和文档处理中（如保持复合词如"non-breaking"在行尾不被拆分）。它与普通的ASCII hyphen-minus（U+002D，即"-“）在视觉上相似，但作为不同的码点，在实际渲染时容易引发兼容性问题。这个问题主要是因为字体支持不完整和宣言引擎的差异造成的。

深入实战：Flutter + OpenHarmony 分布式软总线通信完整实现指南

2502_93572233的博客

12-12

736

本文介绍了如何在OpenHarmony设备上实现Flutter应用通过分布式软总线进行跨设备通信。主要内容包括：环境准备：需配置DevEco Studio、OpenHarmony SDK及定制版Flutter SDK，并添加必要的权限声明。原生服务封装：使用ArkTS实现了完整的DSoftBusService，支持设备发现、会话建立和消息收发功能。桥接层实现：通过MethodChannel和EventChannel将原生能力暴露给Flutter层，实现双向通信。项目特点：支持OpenHarmony

用 Task Local Values 构建 Swift 里的依赖容器：一种更轻量的依赖注入思路

网罗天下方法，方便你我开发！！！

12-16

814

摘要：本文介绍了Swift并发编程中的Task Local Values技术及其应用场景。Task Local Values是一种随Task传播的共享状态，解决了并发环境下上下文信息传递的难题。文章通过请求上下文传递的示例，展示了如何使用@TaskLocal属性包装器定义任务级共享值，并详细讲解了withValue方法的作用范围和注意事项。进一步探讨了该技术在日志追踪、A/B测试等真实场景的应用价值，并创新性地提出基于Task Local构建依赖容器的方案，为Swift项目提供了一种隐式依赖注入的新思路。

09-25

<think> 我们正在处理两个任务：任务1：解决项目中65个文件的许可证头和版权头无效问题（即清除或修正这些文件的开头的许可证和版权声明）任务2：对给定的XML配置文件进行清空或修改操作（具体操作未说明，但根据上下文可能是清空某些配置）由于问题中没有提供具体的XML配置文件路径和内容，也没有说明如何修改，因此我们只能提供一般性指导。对于任务1：通常，许可证头和版权头是添加到源文件开头的注释块。如果这些头无效（可能是格式错误、位置错误或内容错误），我们需要移除或替换它们。由于有65个文件，手动操作效率低，建议使用脚本批量处理。步骤： 1. 确定哪些文件需要修改（例如，所有.dart文件，或者其他类型的文件）。 2. 确定无效许可证头和版权头的具体模式（例如，以什么样的注释开始，包含什么关键字）。 3. 编写脚本（如使用sed、awk或Python）来移除或替换这些头。示例：假设无效的许可证头以多行注释形式存在，以"/*"开始，以"*/"结束，并且包含"LICENSE"或"Copyright"关键字。我们可以使用sed命令（在Linux或macOS上）来移除它们：注意：在操作前务必备份文件！例如，使用sed删除从包含"/*"开始到包含"*/"结束的注释块，并且这个注释块包含"Copyright"或"LICENSE"关键字：但是sed默认是逐行处理，对于多行匹配处理较复杂。我们可以使用以下方式：方法1：使用sed的跨行匹配（但不同平台sed版本支持不同，GNU sed支持，macOS的BSD sed可能不支持）方法2：使用perl或python脚本这里提供一个Python脚本的示例，用于删除以"/*"开头，以"*/"结尾的注释块，并且其中包含"Copyright"或"LICENSE"字样： ```python import os import re # 定义要处理的目录，这里假设是当前目录 directory = '.' # 定义匹配多行注释的正则表达式，注意：这里使用非贪婪匹配 pattern = re.compile(r'/\*.*?(Copyright|LICENSE).*?\*/', re.DOTALL) for root, dirs, files in os.walk(directory): for file in files: if file.endswith('.dart'): # 只处理.dart文件，根据项目实际情况调整 file_path = os.path.join(root, file) with open(file_path, 'r') as f: content = f.read() # 替换掉匹配的注释块 new_content = pattern.sub('', content, count=1) # 只替换第一个匹配（通常头在文件开头） # 如果内容有变化，则写回文件 if new_content != content: with open(file_path, 'w') as f: f.write(new_content) ``` 注意：这个脚本会删除第一个包含"Copyright"或"LICENSE"的多行注释块。但是，有些文件可能有多个注释块，而我们只想删除开头的那个。此外，有些文件的头可能不是多行注释（比如使用//的单行注释），则需要调整正则表达式。因此，我们需要根据实际的头格式来调整脚本。对于任务2：我们需要知道具体的XML配置文件路径和需要做的修改。如果是要清空整个文件，直接覆盖写入空内容即可。如果是删除某些节点，则需要使用XML解析工具。假设我们有一个XML文件，需要清空某个标签内的内容，比如清空<configuration>标签内的所有子节点，但保留<configuration>标签本身。使用Python的xml.etree.ElementTree模块： ```python import xml.etree.ElementTree as ET # 假设文件名为config.xml tree = ET.parse('config.xml') root = tree.getroot() # 找到configuration标签，并清空其所有子节点 config_elem = root.find('configuration') if config_elem is not None: config_elem.clear() # 清空所有子节点 # 保存修改 tree.write('config.xml') ``` 但是，如果是要清空整个文件的内容（即变成空文件），则很简单： ```python with open('config.xml', 'w') as f: f.write('') ``` 由于问题中没有具体说明，我们只能提供这些可能的方案。总结： 1. 对于许可证头和版权头的移除，需要根据实际文件格式编写脚本批量处理。 2. 对于XML配置文件的修改，需要明确具体操作。如果用户能提供更多细节（例如无效头的具体示例，XML配置文件的结构和需要做的修改），我们可以提供更具体的脚本。 </think> 基于您的需求，我将分别解决两个任务：处理无效许可证/版权头和操作XML配置文件。以下是具体解决方案： ### 任务1：解决65个文件的许可证头和版权头无效问题建议使用自动化脚本批量处理，以下提供两种解决方案： #### 方案A：使用Python脚本（推荐） ```python import os import re # 配置参数 PROJECT_ROOT = 'flutter_traceroute_test-main' # 项目根目录 INVALID_HEADER_PATTERNS = [ r'^\/\/\s*Copyright.*?\n', # 匹配// Copyright...格式 r'^\/\*\!\s*license.*?\*\/\s*\n', # 匹配/*! license...*/格式 r'^#.*?license.*?\n' # 匹配# license...格式 ] def remove_invalid_headers(file_path): with open(file_path, 'r+') as f: content = f.read() original_length = len(content) # 移除所有匹配的无效头 for pattern in INVALID_HEADER_PATTERNS: content = re.sub(pattern, '', content, flags=re.IGNORECASE|re.DOTALL) # 重写文件并截断 if len(content) != original_length: f.seek(0) f.write(content) f.truncate() # 遍历项目文件 for root, dirs, files in os.walk(PROJECT_ROOT): for file in files: if file.endswith(('.dart', '.kt', '.java', '.swift')): # 根据实际扩展名调整 remove_invalid_headers(os.path.join(root, file)) ``` #### 方案B：命令行批量处理（Linux/macOS） ```bash # 移除Dart文件中的无效头 find flutter_traceroute_test-main -name "*.dart" -exec sed -i '' '/\/\/.*\(license\|copyright\)/Id' {} + # 移除Android文件中的无效头 find flutter_traceroute_test-main -name "*.kt" -exec sed -i '' '/\/\/.*\(license\|copyright\)/Id' {} + find flutter_traceroute_test-main -name "*.java" -exec sed -i '' '/\/\/.*\(license\|copyright\)/Id' {} + # 移除iOS文件中的无效头 find flutter_traceroute_test-main -name "*.swift" -exec sed -i '' '/\/\/.*\(license\|copyright\)/Id' {} + ``` ### 任务2：XML配置文件操作根据常见需求，提供三类XML操作方案： #### 方案1：清空整个XML文件 ```python def clear_xml_file(file_path): with open(file_path, 'w') as f: f.write('<?xml version="1.0" encoding="UTF-8"?>\n<root/>') # 最小化结构 # 如需完全清空：f.write('') ``` #### 方案2：移除特定节点（示例：移除所有<license>节点） ```python import xml.etree.ElementTree as ET def remove_xml_elements(file_path, tag_name): tree = ET.parse(file_path) root = tree.getroot() # 移除所有指定标签 for element in root.findall(f'.//{tag_name}'): root.remove(element) tree.write(file_path, encoding='utf-8', xml_declaration=True) # 使用示例 remove_xml_elements('config.xml', 'license') ``` #### 方案3：修改特定节点值 ```python def update_xml_values(file_path, updates_dict): tree = ET.parse(file_path) root = tree.getroot() for xpath, new_value in updates_dict.items(): element = root.find(xpath) if element is not None: element.text = new_value tree.write(file_path, encoding='utf-8', xml_declaration=True) # 使用示例 updates = { './/version': '3.0.0', './/author/name': 'New Maintainer' } update_xml_values('config.xml', updates) ``` ### 操作前重要提示 1. **备份文件**：执行前务必备份项目 ```bash cp -r flutter_traceroute_test-main flutter_traceroute_test-main-BACKUP ``` 2. **验证模式**：先在单个文件测试脚本效果 3. **许可证合规**：移除后需确保符合[许可证要求](https://opensource.org/licenses) 4. **XML结构调整**：复杂XML操作建议使用`lxml`库替代标准库 > **注意事项**： > - 许可证头通常包含法律声明，移除前需确认法律允许 > - XML修改可能影响应用功能，建议配合单元测试 > - Flutter项目特别注意`pubspec.yaml`中的许可证声明[^1] 如果需要针对具体文件格式或XML结构进行定制，请提供示例文件片段。