kirk_wang-CSDN博客

原创 HarmonyOS 6.0 服务卡片实战：把「轻食刻」装进桌面，让轻断食一眼可控

本文基于HarmonyOS 6.0 ArkTS开发框架，结合轻食刻健康管理应用的服务卡片Form Kit开发实践，详细解析了formProvider.openFormManager等核心API在实际项目中的应用。通过具体代码示例和架构设计，展示了如何将复杂的健康数据以简洁直观的方式呈现在用户桌面上

2025-11-13 23:08:39 10427 9

原创 Flutter调用HarmonyOS NEXT原生相机拍摄&相册选择照片视频

Flutter调用HarmonyOS NEXT原生方法，到相机相册选择照片视频，相机拍摄图片视频实践

2025-01-21 16:13:00 2789

原创 Flutter三方库鸿蒙适配实战：让flutter_sms在HarmonyOS上跑起来

通过上面这些步骤，我们系统地把Flutter三方库适配到了鸿蒙平台。整个过程从环境配置和源码分析开始，深入到Flutter平台通道的通信机制，然后亲手创建了HarmonyOS端的原生模块。通过实现SmsHelper和，我们完成了短信发送与跳转的核心功能。文章也提供了具体的集成步骤、调试方法和一些通用的性能优化思路。理解桥梁：真正搞明白是连接Flutter Dart和HarmonyOS原生世界的桥梁。对标实现：仔细参考Android/iOS端的原生实现，在鸿蒙侧找到功能对等的API（比如。

2026-01-04 23:16:08 508

原创 Flutter `audio_service` 在鸿蒙端的后台音频服务适配实践

这篇指南主要介绍如何将 Flutter 生态中广泛使用的后台音频播放插件适配到 OpenHarmony 平台。内容从环境搭建、原理分析，到完整代码实现和调试优化，覆盖了整个流程，希望能帮助开发者解决在鸿蒙系统上实现后台音频播放与控制的关键问题。本文详细介绍了将 Flutter插件适配到 OpenHarmony 平台的完整过程。通过构建独立的架构映射：成功将 Android 的Service架构映射到鸿蒙的AVSession架构。功能闭环：完成了后台播放、系统控件交互、状态同步等核心功能的基础实现。

2026-01-04 15:05:47 590

原创将 Flutter 条码扫描插件 `flutter_barcode_scanner` 适配到鸿蒙平台：一次深度实践

鸿蒙生态（HarmonyOS/OpenHarmony）正在快速成长，Flutter 作为跨平台开发框架，对其的支持也在逐步完善。对于开发者来说，将 Flutter 丰富的插件生态移植到鸿蒙平台，不仅能直接丰富应用功能，也是加速项目向鸿蒙迁移的一条捷径。今天，我们就以常用的条形码/二维码扫描插件为例，来聊聊如何将一个只有 Android 和 iOS 实现的 Flutter 插件，深度适配到 OpenHarmony 标准系统上。我会分享完整的适配思路、具体实现、以及踩坑后总结的优化建议。

2026-01-04 10:47:09 666

原创 Flutter 三方库 simple_circular_progress_bar 在 OHOS 平台的适配实践

通过这个库的适配实战，我们完整走了一遍将 Flutter 三方库迁移到 OpenHarmony 平台的流程。从环境搭建、插件架构设计、Dart 与 OHOS Native(C++) 的双向通信，到性能优化和调试，每个环节都进行了探讨。适配的本质，就是为 Flutter 插件在 OHOS 平台建立一个功能对等的原生实现，核心是玩转。技术选型上，OHOS Native API (C/C++) 是实现高性能、深度系统集成插件的最佳路径。代码健壮性。

2025-12-31 14:59:04 602

原创手把手实战：将 flutter_widget_from_html 适配到鸿蒙端

Flutter 凭借高效的渲染和一致的体验，在跨平台开发中一直很受欢迎。现在，鸿蒙生态快速发展，很多团队都希望把现有的 Flutter 应用，连同那些功能丰富的三方库，一起平滑地迁移到鸿蒙平台。但这并非易事，很多 Flutter 库都深度绑定了 Android 或 iOS 的原生能力，怎么让它们在鸿蒙上“跑起来”，成了一个具体的挑战。就是一个典型的例子。

2025-12-31 10:16:50 542

原创 Flutter三方库在OHOS平台适配：firebase_messaging消息推送集成实践

本文分享了将适配到 OpenHarmony 的整体方案。其核心在于理解 Flutter 插件的架构，并为其实现一个鸿蒙端的“壳”，通过 Platform Channel 桥接，把原来的 FCM 语义转换到鸿蒙 Push Kit。几个关键点总结：架构清晰是前提：理解 Flutter 插件的分层设计（Dart → Channel → Platform）是跨平台适配的基础。差异映射是关键：适配的主要工作其实是精确映射FCM 与 Push Kit 在 API、消息格式、生命周期上的差异，而不是重写业务逻辑。

2025-12-30 09:45:59 296

原创 Flutter file_selector 库在鸿蒙（OHOS）平台的适配实践与深度解析

通过这个具体的适配案例，我们走完了将一个 Flutter 三方库移植到 OpenHarmony 平台的完整流程。理解原理是基础：掌握 Flutter的工作机制是前提，关键在于在 OHOS 端实现对应的（通常封装在一个Ability中）。做好概念映射：成功适配离不开准确地将 Android/iOS 的原生概念（如IntentActivity）映射到鸿蒙的对应物（如IntentAbility），并遵循其 API 规范进行实现。工程步骤可复用：流程上可以归纳为。

2025-12-29 11:05:57 950

原创 Flutter三方库在OHOS平台适配实践：wakelock屏幕唤醒管理

通过这次对wakelock插件的 OHOS 适配实践，我们完整地走通了一条将 Flutter 三方库移植到鸿蒙平台的路径。理解 Flutter Plugin 架构掌握 OHOS Native API 的调用方式设计合理的平台抽象接口，以及实现稳健的跨语言通信。总的来说，对于功能明确、在目标平台能找到对应 API 的插件，适配工作是有规律可循的，重点在于熟悉 Flutter 和 OHOS 两边的技术栈。

2025-12-28 09:16:07 800

原创 Flutter flutter_sound 库在鸿蒙平台的音频录制与播放适配实践

通过这个项目，我们系统地将 Flutter 生态中重要的音频库适配到了鸿蒙平台。从分析平台差异、设计适配架构，到实现关键代码和进行性能调优，整个过程验证了 Flutter 插件向鸿蒙迁移在技术上是完全可行的。这次实践带来的核心价值主要有三点方法论的沉淀：我们形成了一套“接口分析-差异映射-分层实现-性能调优”的通用适配流程，以后适配其他插件时可以直接参考。代码的复用：得益于良好的架构设计，我们最大程度地复用了 Dart 层的业务逻辑，只需要替换掉平台原生实现层即可。对社区的贡献。

2025-12-27 22:43:30 699

原创 [鸿蒙2025领航者闯关] Flutter项目适配鸿蒙系统的实践与探索

超过30%的潜在客户明确要求支持鸿蒙工业平板、智慧屏这些设备里，鸿蒙系统的占比已经到45%了适配鸿蒙还能让我们接触到更多智能制造的场景，比如智慧工厂、工业互联网看来这事必须做了。5月初，我们正式启动了鸿蒙适配项目。回顾这两个多月的适配过程，从一开始的迷茫到最终成功上线，踩了不少坑，但也学到了很多。技术变化太快了，得保持开放心态，新东西来了就去学开源社区真的很有用，openharmony-sig提供的SDK和插件帮了大忙团队协作很重要，很多问题都是大家一起讨论才解决的。

2025-12-25 16:30:18 1054

原创 Flutter open_file 插件在 OpenHarmony 平台（OHOS）的适配实践

想将一个成熟的 Flutter 三方插件搬到 OpenHarmony（OHOS）上跑起来吗？本文就以常用的open_file插件为例，聊聊怎么操作。我们不仅会给出详细的步骤，还会深入拆解 Flutter 平台通道（Platform Channel）与 ArkTS 原生能力交互的原理。内容涵盖了从环境配置、目录改造、通信实现到性能优化的全过程，并附上可跑的代码和实测数据，希望能帮你打通 Flutter 应用进入鸿蒙生态的关键一环。通过open_file。

2025-12-24 17:53:48 823 1

原创 Flutter Catcher 在鸿蒙端的错误捕获与上报适配指南

这篇文章详细介绍了把适配到 OpenHarmony 的整个过程。适配的核心思路其实不难：理解 Flutter 的平台通道机制，然后在鸿蒙侧用 ArkTS 实现一个功能对等的处理器。我们从环境搭建、鸿蒙侧实现、Dart 侧集成，再到性能优化，一步步走了过来。原理不变：适配不改动插件原有的工作流程，只是换一个平台实现。代码尽量兼容：通过统一的接口，Dart 代码可以保持多平台一致。处理好平台差异：重点关注鸿蒙在文件系统、网络 API 和权限模型上的不同，并在代码中做相应调整。调试是关键：多利用鸿蒙的。

2025-12-24 11:13:50 584

原创 Flutter `shared_preferences` 三方库在 OpenHarmony 平台的适配实践

在将 Flutter 应用迁移到 OpenHarmony 平台时，数据持久化是首先要解决的挑战之一。作为 Flutter 生态中最常用的轻量级键值存储插件，其官方版本并未覆盖 OpenHarmony。本文将分享我们如何从原理出发，一步步为实现鸿蒙端的原生支持。内容涵盖适配背后的原因、整体架构设计、详细的代码实现、以及在实际集成中可能遇到的问题与优化建议，希望能为类似插件迁移提供一份实用的参考。通过以上步骤，我们系统地完成了插件在 OpenHarmony 平台上的适配。

2025-12-23 14:44:57 883

原创 Flutter animations 库在 OpenHarmony 平台的适配与性能优化实践

这篇实践文章记录了我们将 Flutter 官方纯 Dart 编写的animations库，移植到 OpenHarmony 平台的全过程。整个工作的核心，在于解决 Flutter 动画系统与 OpenHarmony 渲染架构之间的差异所带来的挑战，尤其是性能瓶颈。文中会详细阐述我们的技术选型、具体的适配实现代码、一系列行之有效的性能优化手段，并提供实际的性能对比数据。希望这套经过验证的方法，能为其他 Flutter 生态库在鸿蒙平台的迁移提供参考。

2025-12-22 15:45:24 893

原创 Flutter 鸿蒙项目 Android Studio 点击 Run 失败 ohpm 缺失

CLI 能跑不代表 IDE 能跑，PATH 和 SDK 必须系统级可见；两步补齐，Android Studio 的 ▶️ 就能和一样丝滑。

2025-12-22 15:23:23 705

原创把 Flutter 插件搬上 OpenHarmony：手把手适配音频录制库

通过上面这一系列步骤，我们成功让在 OHOS 上“安家”了。经过测试，这个适配版插件可以在 OHOS 设备上稳定地进行音频采集，功能和原来的 Android/iOS 版本保持一致。回顾整个适配过程，有这么几点体会：吃透原理是关键：真正理解了 Platform Channel，适配工作就成功了一半。它就是个通信协议，我们的任务就是在 OHOS 端实现这个协议。保持结构清晰：严格按照 Flutter 插件的标准格式来组织代码，把 OHOS 实现干净地放在ohos/目录下，后期维护会轻松很多。

2025-12-19 17:49:30 883

原创 Flutter GPUImage 库在鸿蒙平台的 GPU 图像滤镜适配实战

通过上面的流程，我们完整走了一遍将 Fluttergpu_image库适配到 OpenHarmony 平台的过程。不难发现，这类涉及 GPU 和原生图形接口的重度插件，适配并不是简单的代码移植，而是一次针对目标平台图形架构的重新实现。图形 API 转换：用鸿蒙支持的 Vulkan 或原生接口替代 OpenGL ES。数据桥梁重建：设计基于的、与 ohos_flutter 引擎协同的数据交换路径。插件机制适配：利用 ArkUI NAPI 和 FFI 构建通信层。

2025-12-19 15:50:15 1176 1

原创 Flutter 三方库在 OHOS 平台的适配实践

我们以常用的邮件发送插件为例，详细介绍适配过程。该插件允许 Flutter 应用调用系统邮件客户端发送邮件，支持设置收件人、主题、正文、附件等。适配核心思想："接口不变，实现重写"是 Flutter 三方库适配 OHOS 平台的核心思想适配流程：完整的适配流程包括环境准备、插件分析、原生实现、测试验证等步骤性能优化：通过减少通道通信、异步操作、资源管理等方式，可以优化适配后的插件性能最佳实践：遵循 API 一致性、OHOS 设计规范、详细文档、充分测试等最佳实践，可以提高适配质量。

2025-12-19 15:37:28 535

原创 Flutter `flutter_statusbarcolor_ns` 在 OpenHarmony 平台的状态栏颜色适配实践

通过以上步骤，我们完成了插件向 OpenHarmony 平台的适配。理解架构是前提：必须吃透 Flutter 插件的三层架构，特别是平台通道的工作原理，这是成功适配的基础。API 映射是核心：适配的关键在于找到 OpenHarmony ArkUI 中与 Android/iOS 对等的功能 API，并处理好参数转换和传递。工程化保障兼容：通过新增ohos模块并配置多平台支持，可以实现“一套 Dart 代码，多平台原生实现”的优雅方案，既能最大程度复用代码，也降低了维护成本。健壮性决定可用性。

2025-12-19 11:30:11 993

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

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

2025-12-18 09:30:57 274

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

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

2025-12-17 21:40:09 779

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

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

2025-12-16 22:59:06 1015

原创 Flutter 导航锁踩坑实录：从断言失败到类型转换异常

Flutter 导航锁问题虽然常见，但只要掌握了正确的处理方法，就能有效避免。异步隔离、延迟执行、检查状态、统一封装。这次踩坑让我对 Flutter 导航器的工作原理有了更深理解，也建立了一套完整的安全导航方案，希望能帮到遇到类似问题的开发者。

2025-12-16 10:44:03 648

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

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

2025-12-15 14:43:46 1095

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

2025-12-14 15:22:48 609 1

原创 Flutter media_info插件在OpenHarmony平台的适配实践

通过本次实践，我们系统性地完成了media_infoFlutter 插件向 OpenHarmony 平台的迁移。整个过程的核心可归结为“原理映射”与“接口重实现”理解原理：深入理解 Flutter 插件原有平台实现机制和 OHOS 对应能力的技术栈。环境搭建：配置融合 Flutter 与 OHOS 的混合开发环境是基础。代码移植：关键在于在 OHOS 侧实现功能对等的，并妥善处理线程、资源与异常。性能调优：根据 OHOS 平台特性进行针对性优化，提升插件稳定性和效率。

2025-12-13 10:57:50 916 1

原创 Flutter app_settings 库在鸿蒙（OHOS）平台的适配实践与解析

通过对环境搭建：配好 Flutter + OHOS 混合开发环境，生成 OHOS 模块。原理分析：理解原插件在 Android/iOS 的实现原理，找到鸿蒙系统对等的 API（通常是WantAbility架构设计：设计适配层，一般包括一个Plugin类（处理 Channel）和一个或多个Helper类（封装系统功能）。代码实现在下创建对应包结构的 Java 类。实现和接口。使用鸿蒙 SDK 实现具体功能。在主Ability中正确注册插件。Dart 桥接。

2025-12-12 16:13:59 982

原创 Flutter tobias 库在鸿蒙端的支付宝支付适配实践

通过这次实践，我们系统地将 Flutter 的 tobias 支付宝插件成功适配到了 OpenHarmony 平台。整个过程的核心，在于理解并衔接两种不同系统架构间的差异：把 Flutter 的机制映射到鸿蒙的Ability模型上，并基于官方鸿蒙 SDK 重构支付流程。实践表明，Flutter 插件向鸿蒙平台迁移的技术路径是可行的，但需要对两端的架构有清晰的认识。随着 OpenHarmony 生态的不断完善和 Flutter 对 HarmonyOS 支持的持续优化，这类适配工作的复杂度有望进一步降低。

2025-12-12 10:13:00 975

原创 Flutter Printing库在OpenHarmony上的适配实战

通过这个printing库的适配项目，我们算是把Flutter插件迁移到OpenHarmony的完整流程跑了一遍。适配的本质是搭桥：成功的关键在于吃透Flutter插件的通信机制和OpenHarmony的原生API，然后在它们之间建立准确的映射关系。Android代码是重要参考：大部分插件的Android实现（Java/Kotlin）是理解其功能最清晰的蓝图，但我们要做的是基于鸿蒙的架构和API进行“转译”，而不是生搬硬套。性能和体验不能将就。

2025-12-11 17:59:03 954

原创 Flutter 三方库鸿蒙适配手记：让 `flutter_isolate` 在 OpenHarmony 上跑起来

鸿蒙生态的势头越来越猛，很多团队都在考虑把现有的 Flutter 应用搬过去。这事儿的关键之一，就是那些不可或缺的三方库也得能在鸿蒙上工作。这个库在 Flutter 里挺重要的，它负责搞隔离线程（Isolate），专门用来处理计算密集的活儿，防止卡住UI。这次我们就来聊聊，怎么把适配到 OpenHarmony（OHOS）平台。我会从它原来的原理、鸿蒙的并发模型讲起，然后带大家一步步走通环境搭建代码改造和效果验证的整个过程。文章里有完整的、可以跑的代码例子，也总结了一些关键的技术对比和避坑点。

2025-12-10 17:27:32 1085 1

原创 Flutter `video_player`库在鸿蒙端的视频播放优化：一份实用的适配指南

本文系统地介绍了将 Flutter插件适配到 OpenHarmony 平台的完整思路和方案。我们从技术原理上分析了 Flutter 平台通道与鸿蒙原生能力如何对接，并指出了适配的核心在于通信协议、线程管理和生命周期的同步。在实践层面，我们提供了从鸿蒙原生层（）、平台通道桥接到 Flutter Dart 层封装的完整代码示例，涵盖了关键的错误处理。通过实施纹理复用、智能缓冲、硬解优先等优化策略，视频播放的流畅度、响应速度和资源效率都得到了显著提升，测试数据也印证了这一点。这个适配方案不仅解决了。

2025-12-10 10:41:09 408

原创 Flutter path_provider 在 OpenHarmony 平台上的实现与适配实践

通过上面的步骤，我们基本上完成了插件在 OpenHarmony 上的基础适配。整个过程的核心在于理解 Flutter 的插件通信模型，并熟练运用 OpenHarmony 提供的文件系统 API 来“对接”原有的路径获取需求。这次适配带来的价值是明显的：打通了生态基础：许多依赖的 Flutter 插件（如数据库、本地存储类）现在有了迁移到 OpenHarmony 的可能。实现了代码复用：业务层的 Dart 代码几乎无需改动，降低了开发者的迁移成本。提供了一个样板。

2025-12-09 16:18:46 1264

原创 Flutter插件跨平台适配技术分析之是否需要适配鸿蒙端-screenshot

捕获当前渲染的Widget为PNG图像支持捕获不可见的Widget支持捕获长列表Widget支持将捕获的图像保存到本地文件系统支持自定义像素比率和延迟捕获。

2025-12-09 15:05:10 1110

原创为OpenHarmony移植Flutter Printing插件：一份实战指南

这次实践算是成功地把Flutter的printing跑通了一个标准流程：从环境搭建、创建OHOS模块、实现原生Ability，到封装Dart接口，形成了一套可以复用的适配模式。摸清了通信的“门道”：对Flutter Engine和鸿蒙Ability之间如何传递数据、管理生命周期，有了更具体的理解。产出了一份参考代码：围绕“打印”这个具体需求，提供了从权限申请、数据传递到调用系统服务的完整代码示例。总结了优化经验：指出了大文件传输、异步处理等常见的性能坑，并给出了解决方案。

2025-12-08 17:32:07 1085

原创在鸿蒙端适配 Flutter `flutter_native_splash` 库：原理、实现与性能优化

这篇文章我们详细讨论了如何将 Flutter 生态插件——特别是这个启动屏库——适配到鸿蒙平台。我们首先分析了 Flutter 插件的分层架构和鸿蒙系统特性的差异，明确了适配工作的核心就是重写原生平台层的实现。通过具体的代码实例，我们展示了如何构建一个定制的来管理启动生命周期，如何用 ArkUI 创建启动页面，以及如何通过模拟的通信机制，在 Dart 和鸿蒙原生代码之间协调，实现启动屏的定时移除。希望不仅提供了“怎么做”的步骤，也讲清楚了“为什么这么做”的道理。

2025-12-08 16:45:49 1322

原创 Flutter connectivity_plus 在鸿蒙端的完整适配指南：从原理到实践

首先，在 Flutter 插件的 Dart 库中，我们需要定义与鸿蒙端通信的 Channel。通常我们会单独创建一个鸿蒙实现文件，比如。/// HarmonyOS 平台的专属实现/// 与鸿蒙原生端约定的 EventChannel 名称/// 与鸿蒙原生端约定的 MethodChannel 名称（用于主动获取状态）/// 实现：获取当前网络状态@overridetry {// 出错时优雅降级：记录日志并返回默认状态（如.none）

2025-12-08 10:11:16 878 2

原创 Flutter Image Editor 适配鸿蒙HarmonyOS平台实践

通过本次适配，我成功将库适配到了HarmonyOS平台。的核心功能都在Dart层面实现，减少了平台特定代码的工作量HarmonyOS提供了良好的Flutter插件支持，简化了适配过程与Android/iOS的适配架构保持一致，降低了学习成本。

2025-12-05 23:56:37 1389 3

原创 Flutter视频播放器在鸿蒙系统（HarmonyOS）上的适配实践

这篇文章完整地走了一遍 Flutter插件在鸿蒙系统上的适配过程。我们从 Flutter 插件的三层架构讲起，明确了鸿蒙实现作为新的平台实现层的定位。通过分析 Platform Channel 和 Texture 渲染机制，给出了基于鸿蒙AVPlayer和XComponent的完整实现方案，也强调了线程安全、资源管理和错误处理的重要性。这次适配不只是解决了一个具体插件的问题，更总结了一套可以复用的Flutter 插件鸿蒙化方法架构分析：找到目标插件的平台接口层。能力映射。

2025-12-05 22:35:29 1106