1. 为什么偏偏是Flutter:多端复用的现实考量
1.1 OpenHarmony生态的App开发格局
如果你最近关注过开源鸿蒙(OpenHarmony)的设备生态,会发现一个很有意思的现象:市面上的OpenHarmony设备并不像安卓/iOS那样形态统一,而是从几百块钱的开发板、带屏智能家居中控,到部分厂商推出的平板和轻量级手机,跨度非常大。这些设备的系统版本、屏幕尺寸、硬件性能参差不齐,给应用开发带来的第一个问题就是:你到底要为几种平台各写一套UI?
目前OpenHarmony应用开发的主流方式确实是以ArkTS/ArkUI为主,这套声明式UI框架的学习曲线不算陡峭,写起来也颇有几分Compose的味道。但现实是,很多团队手上已经积累了大量Dart/Flutter代码,或者团队成员本身就是跨端出身,让他们为了一个工具类App全面切换到ArkTS,前期学习成本和代码迁移成本都不小。更关键的是,攻略类应用不像系统级应用那样需要深度的系统能力调用,绝大多数页面就是图片、文字、列表、表单,用Flutter这种成熟跨端方案完全能覆盖。
我做这个三国杀攻略App的时候,目标用户手里的设备恰好是"安卓为主、OpenHarmony设备正在变多"的混合状态。与其分别维护安卓原生版本和鸿蒙版本,不如直接把UI层用Flutter统一掉。实测下来,Flutter在OpenHarmony上的2D渲染能力已经能比较稳定地支撑这种轻量工具应用,而且大部分社区依赖包如果是纯Dart实现,几乎不用改就能直接跑起来。这个结论对我后续选型影响很大。
1.2 一套代码,三个平台
武将对比这个功能,从产品视角看是"帮用户快速判断两个武将哪个更适合当前阵容",但从工程视角看,它涉及了页面路由、数据解析、列表渲染、状态切换、图片缓存、甚至一点简单的文本相似度算法。如果用原生三端分别实现,同样的逻辑要写三遍,后续改一个评分公式就要同步改三处,维护成本会成倍增加。
Flutter在这里的真实收益体现在三个层面。第一,UI层复用:双栏对比卡片、技能差异高亮、VS分割线这些组件在三个平台上表现一致,不需要为某个平台单独调样式。第二,逻辑层复用:武将体力、技能覆盖度、爆发/防御评分这些计算逻辑全部写在Dart层,和平台无关。第三,热重载效率:调试对比页布局时,改完代码保存,模拟器上几乎秒级刷新,这比原生改完编译再部署的循环快太多了。如果你后续还想覆盖iOS端,这套代码不需要大改,因为武将对比功能几乎没有用到平台专属能力,纯Flutter实现就够了。
当然,跨端不等于零成本,Flutter for OpenHarmony的适配层目前还属于快速迭代阶段,有一些工程层面的坑需要提前踩一遍。接下来我就从工程配置开始,把整个实战过程中最关键的部分拆开讲。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. OpenHarmony适配要注意的工程配置细节
2.1 从标准Flutter工程到OpenHarmony工程
先明确一个概念:Flutter官方主分支默认生成的工程是不带OpenHarmony适配目录的。我用的方式是创建标准Flutter工程后,用OpenHarmony侧的适配工具生成ohos目录,再把业务代码迁过去。整个流程大致是这样:
- 创建Flutter工程,flutter create hero_compare,语言选Dart,平台先勾选android、ios。
- 确认本机Flutter SDK版本。这里要特别留意,OpenHarmony的Flutter适配分支对SDK版本有明确要求,版本太新或太旧都可能出现编译错误,后面我会详细说。
- 在工程根目录执行OpenHarmony适配初始化命令,生成ohos目录。生成后目录结构大概是这样:ohos/entry/src/main/ets/pages/Index.ets是原生入口页,它负责加载Flutter容器。
- 修改ohos工程的包名和应用图标,把默认的com.example替换成你自己的applicationId,这一步在后续发版签名时会直接影响到产物id,别拖到最后才改。
- 在ohos/local.properties里配置本地SDK路径,在ohos/build-profile.json5里配置签名信息。
这一步做完,理论上已经可以在OpenHarmony设备或者模拟器上跑起来一个空Flutter页面。但我第一次在这个环节就卡住了,而且报错信息非常经典,就是热搜词里那个"you are applying flutter's main gradle plugin imperatively using the apply"问题。
