电子工业出版社-网上书店

本书旨在帮助开发者深入了解如何将 Flutter与鸿蒙系统进行整合，涵盖从基础环境配置到实际开发的各个方面。首先，本书介绍了 Flutter 与 Dart 的基本概念，以及鸿蒙系统（包括 HarmonyOS、OpenHarmony 和 ArkTS）中的关键技术，帮助读者理解这三者的技术背景与关系。接着，详细讲解了如何在 Windows 和 macOS 上配置鸿蒙 Flutter 开发环境，并通过示例带领读者创建第一个鸿蒙 Flutter 应用。本书还深入探讨了在鸿蒙应用中添加 Flutter 页面,使用Channel实现 Flutter 与鸿蒙通信的能力，使用Platformview实现Flutter和鸿蒙Next实现混合渲染，Flutter鸿蒙化主流三方插件适配的使用和介绍,开发 Flutter 静态库和优化性能。书中不仅包含了开发工具的使用方法，还特别关注了如何解决开发过程中可能遇到的各种问题，如性能分析、平台适配、上架审核等。无论是 Flutter 开发者希望将现有项目迁移到鸿蒙平台，还是初学者希望从头开始构建鸿蒙 Flutter 应用，本书都提供了详细的指导和实践经验，帮助读者高效掌握相关技术，顺利完成开发与发布。

目　　录
第1章　入门基础	1
1.1　Flutter框架介绍	1
1.2　Dart介绍	3
1.3　Flutter鸿蒙化背景	4
第2章　HarmonyOS开发基础	8
2.1　HarmonyOS介绍	8
2.2　OpenHarmony介绍	9
2.3　HarmonyOS与OpenHarmony	10
2.4　HarmonyOS NEXT介绍	12
2.5　OpenHarmony、HarmonyOS、HarmonyOS NEXT的差异	13
2.6　ArkTS语言介绍	15
第3章　开发环境搭建	18
3.1　Windows环境配置	18
3.2　Mac环境配置	22
3.3　OpenHarmony设备运行指导	27
3.4　鸿蒙版Flutter版本管理利器：FVM使用指南	36
3.5　Flutter-OH版本演进规划和分支策略核心要点	44
第4章　第一个鸿蒙Flutter应用	46
4.1　创建项目	46
4.2　如何在鸿蒙应用中添加新页面	48
4.3　现有Flutter项目支持鸿蒙	49
4.4　鸿蒙Flutter应用的多设备运行指南	52
4.5　鸿蒙Flutter开发模式	58
4.6　Flutter开发鸿蒙应用时第三方库引入指南	59
第5章　Flutter混合开发	68
5.1　概述	69
5.2　源码模式引入	72
5.3　Har包模式引入	75
5.4　初始化Flutter	78
5.5　跳转Flutter页面	83
5.6　使用FlutterChannel与鸿蒙通信	93
5.7　如何使用Flutter和鸿蒙Next混合渲染	101
5.8　混合渲染开发实践：以fluttertpc_scan第三方库为例	111

第6章　插件开发与适配	123
6.1　背景介绍	123
6.2　鸿蒙版Flutter高效使用Package指南	124
6.3　插件适配原理	127
6.4　插件开发	129
6.5　联合插件开发	132
6.6　开发FFI Plugin	135
6.7　版本升级适配	136
6.8　插件测试	141
6.9　如何升级插件至最新的鸿蒙版Flutter	147
第7章　高级特性与优化	151
7.1　Flutter OHOS外接纹理适配简介	151
7.2　如何使用多引擎FlutterEngineGroup	156
7.3　如何使用PlatformView	159
7.4　PlatformView同层渲染方案适配切换指导	167
第8章　Flutter性能分析与调试	169
8.1　使用FlutterEngine编译	169
8.2　性能调优	171
8.3　Flutter Impeller鸿蒙化实践	173
8.4　性能分析定界指南	178
8.5　梳理线程顺序	180
8.6　性能分析：滑动响应时延	182
8.7　性能分析：帧渲染跟踪	184
8.8　如何调试代码	186
8.9　在Flutter中实现鸿蒙平台引入Package	187
8.10　使用hvigor插件方式编译Flutter项目	188
第9章　第三方库适配实战	193
9.1　如何快速判断Flutter库是否需要适配鸿蒙	193
9.2　FlutterToast第三方库鸿蒙适配之旅	198
9.3　flutter_udid第三方库鸿蒙适配之旅	204
9.4　memory_info第三方库鸿蒙适配之旅	216
第10章　Flutter鸿蒙应用开发实战	224
10.1　鸿蒙版Flutter直接拨号功能解析	224
10.2　鸿蒙版Flutter使用url_launcher插件打开百度地图或高德地图进行导航	226
10.3　用Flutter开发鸿蒙PC应用	229
第11章　Flutter鸿蒙应用上架审核	236
第12章　Flutter鸿蒙应用FAQ	243
12.1　环境配置与常见问题解决	243
12.2　ohos应用编译相关问题	251
12.3　鸿蒙版Flutter开发中涉及的申请权限问题	252
12.4　OHOS代码开发相关问题	253
12.5　鸿蒙Flutter开发常见问题解答	255
第13章　Flutter鸿蒙版本与优化	259
13.1　鸿蒙版Flutter开发：平台判断与问题处理指南	259
13.2　鸿蒙版Flutter升级OHOS构建过程：支持依赖插件源码构建	261
13.3　鸿蒙版Flutter适配新命令--use-application-binary	265
13.4　关于插件参数传递	266
13.5　关于鸿蒙版Flutter的Context	267

序
2023年8月，HarmonyOS NEXT开发者预览版发布，我毅然决定投身鸿蒙领域。那时的鸿蒙，已经开源四年，从风雨飘摇中襁褓里的新生儿，悄然成长为蹒跚学步的孩童。
次年盛夏，我赴松山湖参加HDC大会，第一次亲手体验运行原生鸿蒙系统的手机：界面精致、交互流畅，完成度之高令我惊叹。若非亲眼所见，很难想象在离开庞大的安卓生态之后，我们竟真能一步步再造一个全新的鸿蒙世界。而这一切的前提，华为无比清醒—唯有坚持开放与开源，方有生态的可能。
回到杭州的一个夏夜，窗外车流如织，当Flutter在鸿蒙NEXT上成功运行的那一刻，以流畅著称的Flutter没有辜负期待——应用首页帧率直抵120，媲美原生。我按捺不住激动，发了一条朋友圈：
“鸿蒙原生，启动！”
不仅我的第一个鸿蒙原生应用顺利启航，我的鸿蒙布道之路，也自此展开。
Flutter作为一套全平台跨端框架，将开源社区的丰富生态注入鸿蒙。与此同时，React Native、Taro、KMP、UniApp等众多跨端框架，也在迅速适配、融入开源鸿蒙的世界。
因为开源，所以生动。对许多开发者而言，鸿蒙是一片值得探索的“新大陆”。在这里，除了华为原生的ArkTS、仓颉与ArkUI，更需要引入所有主流开发语言、框架与浩如烟海的第三方库—我们不仅是在适配，更是在创造。
于是，“坚果派”应运而生。这是一群热爱开源、拥抱鸿蒙的极客。很幸运，我也成了其中一员。
行百里者半九十，这本《鸿蒙Flutter开发实战》只是一个起点。我们不仅希望分享第一手的鸿蒙跨端开发经验，也期待更多伙伴加入第三方库的贡献中，加入“坚果派”的大家庭。
路漫漫其修远兮，吾将上下而求索。

少湖   
2026年元月
于钱塘江畔?
前    言
HarmonyOS（鸿蒙操作系统），是华为公司于2019年8月推出的面向全场景的分布式操作系统。2023年8月，HarmonyOS NEXT（原生鸿蒙）发布，这是HarmonyOS自发布以来，弃用Linux内核及AOSP（安卓开放源代码项目）等代码的首个大版本，该版本不再兼容安卓应用。至此，HarmonyOS从同时兼容安卓和鸿蒙的双框架过渡到只支持鸿蒙的单框架。截至2026年4月，搭载HarmonyOS的鸿蒙生态设备已超过5100万台。
OpenHarmony（开源鸿蒙操作系统）为HarmonyOS的开源版本，从2020年发布首个版本以来，历经多次迭代，截至2026年4月，该系统6.1.0 Release版本已发布。
Flutter是Google推出的开源跨平台应用开发框架，支持Android、iOS、Windows、Linux、MacOS、Web六大平台。
HarmonyOS Next和OpenHarmony支持使用ArkTS语言开发原生鸿蒙应用。同时，经过开源鸿蒙社区各参与方的共同努力，这两个系统已支持流行的跨平台应用开发框架，如Flutter、React Native、Taro、UniApp等。
本书将介绍如何使用Flutter框架，开发原生鸿蒙应用。从Flutter和Dart的基础知识讲起，引入HarmonyOS、OpenHarmony、ArkTS的知识概念，由浅入深，逐步介绍Flutter鸿蒙化的原理、开发环境配置、页面开发、通信机制、混合渲染、第三方库、性能调优等内容，帮助开发者学会使用Flutter开发原生鸿蒙应用。紧接着，本书介绍了上架应用商城的流程和注意事项，整理了常见开发问题，帮助开发者全方位掌握应用上架的全过程。同时，本书介绍了诸多开发实践经验、性能调优思路、第三方库适配案例，具有很高的参考价值。
本书所介绍的案例都是在MacOS/Windows及openharmony-tpc提供的Flutter SDK 3.35环境下调试通过的。
在本书编写的过程中，得到了坚果派开发者的小伙伴，以及西安交通大学谢涛团队、深圳技术大学李蒙团队、深圳职业技术大学王贤辰团队、深圳信息职业技术大学邹海鑫团队、上海杉达学院祝欣蓉团队、西安工商学院张琳团队、兰州信息科技学院王娟娟团队等的帮助，在此表示感谢。
需要本书相关源代码的读者，请到https://atomgit.com/nutpi/gitbook-harmonyos-flutter网页下载。
由于能力有限、成书仓促，书中难免存在纰漏，还请读者不吝赐教。

编   者

本书配套资源下载

对不起，暂无音视频资源！