
本文来源:http://www.lpqz.cn/news/58668
若有版权问题,请来信告知:13951431913#139.com 或在右方提交评论。
最近团队接了个活要做一款单位换算工具需求很明确覆盖Android、iOS还要兼容鸿蒙。做了这么多年客户端我太熟悉这种“三端都要”的玩法了——以前意味着三个项目组、三套代码、三份测试最后往往是Android和iOS各做各的新系统来了再另起炉灶。这次我不想再走老路决定用Flutter把这活儿一锅端了。这里我得坦白讲最初我对Flutter跑鸿蒙这件事是有疑虑的。毕竟鸿蒙生态曾经走过一段“兼容Android”的过渡期很多团队直接拿APK装上去完事但单位换算大师这种要配合鸿蒙原生服务、最终走鸿蒙工具链上架的应用迟早得走hap这条路。直到我深入研究并把OpenHarmony分支的Flutter SDK真正跑起来之后才确认这条路是通的而且体验比想象中顺畅。这篇内容写给谁看想用一套Flutter代码同时产出Android、iOS、鸿蒙三端应用的人或者团队里有Flutter鸿蒙适配任务、但不确定技术路线能否
落地的小伙伴。我会把选型思路、环境搭建、代码设计、打包发行的完整流程都写出来所有过程都是实际跑过的不是对着文档空想。1. 选型复盘为什么是Flutter而不是ArkUI或uni-app1.1 三套原生的成本算不过账先看最朴素的方案Android一套KotliniOS一套Swift鸿蒙一套ArkTS。理论上这是“最正统”的路线平台能力跟得最紧性能和体验也最可控。可一旦把一个工具型应用拆开算账事情就完全不一样了。单位换算大师的核心页面大概包括换算主界面、单位分类选择、历史记录、收藏列表、设置页。粗看不多但每个页面都要处理状态管理、主题切换、深浅色模式、动画动效、本地数据持久化三套写下来就是三份完全独立的代码库。更麻烦的是后续迭代——加一个新单位分类三个端要同步改改一个交互细节三个端要同步评审。对一个小团队来说三倍的人力意味着项目周期至少翻两倍这在产品侧根本等不起。所以当时的第一判断就是必须有跨
平台方案。跨平台的目的不是省掉“写UI”的人力而是省掉“同一套业务逻辑在不同语言里反复翻译”的人力以及后续迭代时“一个功能改三遍”的隐性成本。选择Flutter的另一个潜意识因素是团队里有人写过Dart语法上手成本低这是选型时容易被低估的点。1.2 各跨平台方案在鸿蒙上的适配现状对比选型的时候我把自己熟悉的跨平台方案过了一遍逐一去查它们在鸿蒙生态的适配情况。React Native社区适配方案存在但版本跟进速度偏慢部分原生模块需要自己封装桥接踩坑资料也比较少遇到问题容易卡死。uni-app国内生态做得不错自己也发布了鸿蒙适配版本适合以国内业务为主的H5类应用但如果团队已经习惯了Flutter的渲染模型和Widget体系切换过去需要不少心理成本。Flutter最早对第三方生态开放度最高的跨平台方案之一OpenHarmony分支的Flutter SDK已经能跑通主线工程并且网络、存储、状态管理
等常用基础库都有对应的适配成果。我做了一个简单的对比表方便还在犹豫的人快速判断方案Android表现iOS表现鸿蒙适配现状工具链成熟度个人结论原生三套优优优优成本过高Flutter优优较成熟能出hap中高推荐React Native良良社区方案版本滞后中观望uni-app良良有官方适配但深度一般中高可备选这里特别想说明一点Flutter之所以能在鸿蒙上跑起来核心在于它的渲染层是自己用Skia后来逐步引入Impeller自绘的不依赖各平台的原生UI组件。也就是说只要把引擎的嵌入层适配到鸿蒙的Surface上Dart层的业务代码几乎不用动。这套架构设计当初是为了保证跨端UI一致性现在反而成了它拥抱新平台的最大资本。1.3 单位换算这个场景为什么特别适合Flutter单从业务来看单位换算大师是一个非常“标准”的Flutter应用UI完全自绘可控不需要嵌入复杂的原生地图、视频、3D画布等重型组件核
心逻辑是纯Dart的换算计算没有平台差异本地存储只需要保存历史记录和用户偏好不依赖平台级数据库即使后续要加图库选图、应用内支付这些原生能力也有MethodChannel可以打通。这几点凑在一起意味着Flutter的“跨平台红利”在这个项目里能吃到最大。说白了越是不依赖平台特性的应用越适合用Flutter做。反过来如果你要做的是一个需要重度调用底层硬件能力的应用那Flutter的优势会被削弱需要投入额外精力做原生插件的适配。2. 环境准备搭出能出鸿蒙hap的Flutter工程2.1 需要的工具清单这一步是整个过程中最容易被低估的。很多人卡在“环境跑不起来”上其实不是技术难度而是版本对应关系没搞对。我这边最终稳定的工具版本组合如下DevEco Studio用于鸿蒙工程的导出、签名、打包日常写代码时不一定要打开Flutter SDKOpenHarmony分支从官方仓库拉取的适配版本不是原版flu
tter/flutterohpm鸿蒙的包管理器类似npm安装原生依赖时要用Node.js部分自动化脚本依赖Java JDKDevEco Studio运行依赖。这里有个很关键的认知OpenHarmony分支的Flutter SDK和官方主线的SDK并不是简单的小版本差而是带有专门的鸿蒙平台嵌入层。所以环境变量里配置的flutter路径一定要指向这个分支否则你执行flutter create的时候根本看不到鸿蒙的工程选项。我当时先装了原版Flutter又装了鸿蒙分支PATH变量指错了顺序结果折腾了快一下午才反应过来。2.2 创建支持鸿蒙的Flutter项目工具链就位后创建项目的步骤大致是这样用Flutter SDK创建标准的Flutter工程在工程目录下执行与鸿蒙平台相关的初始化命令生成entry模块、hvigor配置、oh-package.json等鸿蒙工程结构用DevEco Studio打
开生成的鸿蒙工程目录等待hvigor自动同步依赖执行构建首次构建时间会偏长因为引擎要编译成鸿蒙的so库。命令行层面大概长这样具体命令以你拉取的SDK分支说明为准flutter create --org com.example unit_converter cd unit_converter flutter build hap --debug第一次跑通的时候还挺感慨一个原本为Android/iOS设计的Flutter工程竟然真的能输出hap包。这说明鸿蒙适配分支的完成度已经很高了。2.3 最容易翻车的环境坑下面这几个环境坑我基本都踩过一遍列出来帮你省时间JDK版本对不上DevEco Studio的要求同步阶段会报各种奇怪错误。解决办法是打开DevEco Studio的设置页确认它内置的JDK版本然后用同样的版本配置JAVA_HOME。Flutter分支版本和OpenHarmony SDK版本
错位。建议优先使用适配分支release说明里锁定的组合不要各取最新否则编译时可能会遇到API签名不一致。我的习惯是先把适配分支的README完整看一遍把推荐的版本组合记录下来再动手。ohpm仓库默认源可能不稳定可以配置镜像源。这一步属于国内开发环境的常规操作核心是让依赖拉取更顺畅。首次构建需要下载大量依赖和引擎产物如果网络条件不好很容易超时失败。我的做法是先手动执行一次全量构建让它把所有依赖缓存下来之后的小改动就不需要反复下载了。3. 单位换算大师的数据模型与换算引擎设计3.1 先理清功能需求动手写代码前我习惯先把功能边界划清楚。单位换算大师第一版需要支持至少6大类单位长度、重量、温度、面积、体积、时间每大类下有常用子单位比如长度包含米、千米、厘米、毫米、英尺、英寸、英里等换算方向要支持“任意单位到任意单位”不能只做“第一行到第二行”需要保留最近20条换算记录用户可以收藏常用换算组合支持
深色模式自动跟随系统。这里面最有意思的是换算引擎的设计。一开始我想得很简单——每个单位存一个对基准单位的系数换算时先转基准单位再转目标单位一步到位。后来一写才发现温度这种单位根本不乐意配合华氏度和摄氏度之间是偏移加比例的关系用一个固定系数根本搞不定。3.2 数据模型设计我的最终设计是这样的enum UnitCategory { length, weight, temperature, area, volume, time } class Unit { final String id; final String name; final UnitCategory category; final double Function(double)? toBase; final double Function(double)? fromBase; final double? linearFactor;
}对绝大多数线性单位长度、重量、面积、体积一个linearFactor就够了。比如米linearFactor 1因为基准单位就是米千米linearFactor 1000厘米linearFactor 0.01。换算逻辑就是从源unit先执行toBase拿到基准值再执行目标unit的fromBase得到目标值。线性单位下这俩函数都可以由linearFactor自动生成不需要为每个单位手写。温度这种非线性单位则直接给出两个函数final celsius Unit( id: celsius, name: 摄氏度, category: UnitCategory.temperature, toBase: (c) c, fromBase: (b) b, ); final fahrenheit Unit( id: fahrenheit, name: 华氏度, category: UnitC
ategory.temperature, toBase: (f) (f - 32) * 5 / 9, fromBase: (c) c * 9 / 5 32, );这样设计的好处是线性单位可以用统一工厂方法快速注册非线性单位只需额外多写两个函数整个注册表非常清爽。后续要加一个新的单位比如“海里”或“开尔文”只需要在数据表里追加一行定义UI无需任何改动。3.3 换算引擎核心实现换算服务本身是纯Dart类不依赖任何Flutter组件这样就能放进单元测试里直接验证class UnitConverter { double convert(double value, Unit from, Unit to) { if (from.category ! to.category) { throw ArgumentError(单位类型不一致无法换算); } if (from.linearFactor !
null to.linearFactor ! null) { // 线性单位走基准系数 return value * from.linearFactor! / to.linearFactor!; } // 非线性单位走自定义函数 final baseValue from.toBase!(value); return to.fromBase!(baseValue); } }这段代码看起来简单但真正决定换算结果正确性的是每个单位注册时参数对不对。我实践下来的建议是每个分类单独写一组单元测试把所有相邻关系都测一遍。别看这些测试占时间没有它们后续更新单位表时改错一个系数用户到处报问题排查起来反而更痛苦。比如重量分类里“斤”和“公斤”的系数稍不留神就错了一个量级。3.4 历史记录与收藏的持久化历史记录和收藏量都不大我直接用的shared_preferences把数据序列化成JSON数组存到本地
。单条记录就是一组源单位、目标单位、源值、目标值、时间戳。之所以不引入完整数据库是因为这个量级的读写用数据库反而是一种负担维护起来也重。一个很容易踩的点是shared_preferences的写入不是即时的快速连续操作时如果不加await偶发会丢记录。我一开始没在意连续换算时发现历史列表偶尔少了一条排查了很久才定位到是异步竞争问题改成await顺序执行后就稳定了。4. 一套UI跑三端页面结构与鸿蒙适配细节4.1 页面整体划分界面设计上我没有刻意做复杂布局遵循了Flutter惯用的结构底部导航三个Tab换算、历史、设置换算页顶部是单位分类横向滚动条下面是一个标准换算卡片历史页用ListView展示最近记录长按可收藏设置页放深色模式开关、字体缩放、关于信息。这套结构在Android、iOS、鸿蒙上跑出来的观感几乎一致这正是Flutter自绘引擎的价值。但“几乎一致”不等于“完全一致”平台差异主
要藏在细节里。如果是Content-Type导向的页面布局Flutter天然优势很大但遇到平台专有交互习惯还是得针对性做适配。4.2 鸿蒙安全区和状态栏适配这里必须单独讲一讲。鸿蒙系统的安全区策略和Android、iOS都有区别尤其是在挖孔屏、胶囊键和底部导航条的处理上Flutter默认的SafeArea通常只能覆盖最基本的padding有些场景需要手动处理。我常用的做法是监听系统状态栏高度变化然后动态调整顶部留白final statusBarPadding MediaQuery.of(context).padding.top; final bottomPadding MediaQuery.of(context).padding.bottom;在单位换算大师里换算卡片和底部导航之间需要保持足够间距否则在部分鸿蒙设备上会出现“导航条遮挡内容”的问题。这个细节如果不上真机光靠模拟器几乎发现
不了等上线后用户反馈就晚了。所以后来我的测试计划里专门加了一条所有关键页面必须在真机上过一遍安全区检查。4.3 深色模式与字体缩放深色模式在Flutter里用ThemeData的brightness字段切换逻辑本身很简单。但单位换算场景有个特殊性大量展示数字和单位符号颜色对比度直接关系到可读性。我最终确定的配色方案是正文用主色加15的明度偏差弱化文字用主色加40的明度偏差背景色在深色下不用纯黑而用偏蓝灰的深色这样长时间看屏幕不会刺眼。字体缩放也是一个容易被忽略的点。很多工具类应用在系统字体调大后布局直接崩整行文字从卡片里挤出来。我当时的做法是给关键数字区设置最小字号同时用Flexible和FittedBox控制文本溢出行为保证用户在鸿蒙系统设置里把字体调到最大时界面仍然可用。这个适配用真机来回测了好几次才找到比较舒服的边界值。4.4 同一套Widget在不同主题下的行为差异最后提醒一句Fl

本文来源:http://www.lpqz.cn/news/58668
若有版权问题,请来信告知:13951431913#139.com 或在右方提交评论。
A recent project called for a unit-conversion tool covering Android, iOS and HarmonyOS. After years of client work the author knows what three platforms usually means: three teams, three codebases, three test suites, with Android and iOS drifting apart and a brand-new effort whenever a new OS appears. This time the decision was to build the whole thing in Flutter and document the selection reasoning, environment setup, code design and release process end to end, based on steps actually executed rather than documentation reading.
The naive option — Kotlin for Android, Swift for iOS and ArkTS for HarmonyOS — simply does not add up in cost. The point of cross-platform is not saving the effort of writing UI but saving the effort of translating the same business logic into several languages and, more importantly, avoiding the hidden cost of implementing every new feature three times afterwards. A secondary factor was that someone on the team already knew Dart, so ramp-up was cheap — an easily underestimated consideration. The comparison table rated native development excellent on all three platforms but prohibitively expensive; Flutter excellent on Android and iOS with relatively mature HarmonyOS adaptation able to emit a hap package and medium-to-high toolchain maturity; React Native good on the first two but reliant on a lagging community solution for HarmonyOS; and uni-app good on the first two with official adaptation but deeper limitations.
The app itself is well suited to Flutter: the core conversion logic is pure Dart with no platform differences, local storage only needs history records and user preferences rather than a platform-level database, and future native features such as image picking or in-app payment can still be reached through MethodChannel. In short, the less an application depends on platform-specific capabilities, the more of Flutter's cross-platform dividend it can capture. Environment setup includes the OpenHarmony fork of the Flutter SDK, the ohpm package manager (similar to npm), Node.js for some native dependencies, the Java JDK for certain automation scripts and DevEco Studio. A crucial detail is that the OpenHarmony Flutter SDK is not a minor version difference from the mainline SDK: it carries a dedicated HarmonyOS platform embedder.
After running flutter create, the generated HarmonyOS project directory is opened so hvigor can synchronise dependencies and perform the first build, which takes noticeably longer because the engine must be compiled into HarmonyOS shared libraries. The command-line flow follows the SDK branch instructions rather than the upstream defaults. From there the article covers widget structure, platform-channel boundaries, and packaging and release for all three targets, with the practical conclusion that a single Dart codebase is viable today provided the team treats HarmonyOS as a first-class build target from the start instead of an afterthought.