最近在搞 Flutter 在 OpenHarmony 上的落地,拿一个信息流 App 练手,第一步就是把顶部标签栏做出来。这里说的顶部标签栏,不是 Android 那种简单的 TabLayout,而是 Flutter 里一套完整的 TabBar + TabBarView 联动机制,同时还得让它在 OpenHarmony 真机上跑起来。这套组合说白了就是跨端框架碰到新系统后,最典型也最容易被卡住的场景——框架本身没问题,环境、依赖、平台差异全在等着你。
这篇东西不是官方文档翻译,是我从零开始在 OpenHarmony 设备上跑 Flutter 顶部标签栏的完整记录。内容包括环境选型、TabController 用法、页面状态保持、鸿蒙适配差异,以及我踩过的几个坑。适合两类人看:一类是刚接触 Flutter 想搞懂标签栏怎么写的新手,另一类是已经在 OpenHarmony 上用 Flutter 开发、正被各种兼容问题折腾的同学。
1. 环境准备与工程搭建要点
1.1 选对 Flutter SDK 分支
OpenHarmony 上的 Flutter 不是从 flutter 官网直接下载的。官方维护了一个独立分支,仓库在 openharmony-sig/flutter_flutter,目前比较稳的是 OpenHarmony 3.2/4.x 对应的分支。我当时用的命令是:
bash复制git clone -b OpenHarmony-4.0-Release https://gitee.com/openharmony-sig/flutter_flutter.git
export PATH=$PATH:$HOME/flutter_flutter/bin
flutter doctor
flutter doctor 会提示找不到部分工具链,这个正常,OpenHarmony 的 Flutter 依赖 HarmonyOS SDK 和 DevEco Studio 配合,具体后面说。如果你之前电脑上装了标准 Flutter SDK,切记要把 PATH 切到 openharmony-sig 这份上去,两个版本混用会导致依赖解析错乱。
注意:项目开发机上我同时保留了两种 SDK,用的时候通过修改 .bashrc 或者终端里 export PATH 来切换,避免下载资源冲突。实测中混用版本最容易出的问题就是 pubspec.lock 里记录的上游 SDK 版本不一致,一旦报错先看 lock 文件。
1.2 初始化支持 ohos 平台的项目
SDK 切换到位后,创建项目时可以直接带上 ohos 平台:
bash复制flutter create --platforms ohos my_app
cd my_app
正常情况下会自动生成 ohos 目录,结构和 android/ios 同级。如果老项目,可以用命令把 ohos 平台补上:
bash复制flutter create --platforms ohos .
接着打开 DevEco Studio,导入项目里的 ohos 目录。开发中我会把多数代码放在 lib/ 下,ohos/ 目录主要负责原生侧的配置文件、权限声明和应用签名。注意 ohos 目录不能当作普通 Flutter module 目录去处理,很多编译问题都是因为用 Android Studio 的思路去打开 ohos 工程导致的。
真机调试设备我用的是一块 RK3568 的开发板,跑的是标准系统镜像。设备树的事大部分发生在烧录环节,应用层开发一般不用管;只有在自己裁剪内核或改驱动时才需要根据板子型号去选对应 dts,普通跑 Flutter 不会碰到这一步。
1.3 环境变量与签名配置
OpenHarmony 平台上构建和运行还需要配置几个变量,我整理了一份自己的 .bashrc 片段,避免每次开终端都要敲一遍:
bash复制export FLUTTER_ROOT=$HOME/flutter_flutter
export OHOS_SDK_HOME=$HOME/ohos-sdk
export PATH=$FLUTTER_ROOT/bin:$OHOS_SDK_HOME/toolchains:$PATH
签名上,我们通常在 DevEco Studio 里生成一个自动签名配置,这步和 Android 里的 debug keystore 类似,但 OpenHarmony 的签名体系完全不同,你必须在工程里创建一个签名证书,否则即使 flutter run 编译成功,安装到真机也可能报签名错误。比较稳妥的做法是先在 DevEco Studio 里跑通一次 ohos 侧构建,让签名文件生效后,再回到 flutter 命令运行。
我遇到的坑:直接用 flutter run 不带签名配置启动到 RK3568 时,提示类似"install sign
