1. 为什么我在OpenHarmony上赌Flutter,以及工程初始化踩过的坑
1.1 选型盘点:ArkUI、RN for OpenHarmony 还是 Flutter
做智慧学习助手这个项目的时候,团队内部其实吵过一轮选型。当时摆在我们面前的无非是三条路:直接用ArkUI写原生、拿React Native for OpenHarmony套壳、上Flutter for OpenHarmony。
ArkUI的优势在于它是OpenHarmony的“亲儿子”,组件和系统能力对齐得最紧,调个媒体播放、申请权限、拿设备信息都最省事。但问题也很现实:团队里Android和iOS的同事对ArkTS这套声明式语法并不熟,重新学一套UI框架的成本并不低。更关键的是,ArkUI的生态还比较有限,三方库的数量远远没法跟Flutter那套成熟生态比。
RN for OpenHarmony是我们第二个认真评估的对象。RN的桥接层在OpenHarmony上还没完全成熟,很多原生模块的映射是半成品状态,遇到问题时你很难判断到底是RN的锅还是OpenHarmony适配层的锅。我们拿一个简单的列表页在RK3568开发板上跑了跑,滚动时的帧率表现只能说勉强够用,动态加载图片稍微多一点就开始掉帧。
最后选Flutter的理由其实很朴素:团队里已经有几个同事攒了两三年Flutter开发经验,代码库里有现成的组件沉淀,业务逻辑不用换语言重写。加上Flutter for OpenHarmony这个项目是OpenHarmony SIG在持续推的,社区活跃度比RN那条线高不少,出了问题能找到人问的几率大很多。虽然引擎在OpenHarmony上的适配还不算100%完美,但对于课程详情这种以列表、图片、视频跳转为主的信息型页面,Flutter的性能底子是足够的。
1.2 工程初始化与工具链配置
OpenHarmony上的Flutter工程初始化,流程跟标准Flutter还是有一点区别。首先SDK不能用官方分支,得从OpenHarmony SIG维护的仓库拉开发分支,我这次用的是OpenHarmony-5.0这个tag。
bash复制git clone -b OpenHarmony-5.0 https://gitee.com/openharmony-sig/flutter_flutter.git
export PATH=$PWD/flutter_flutter/bin:$PATH
flutter doctor -v
flutter doctor的输出里会多出一个ohos-toolchain的检查项,如果你的DevEco Studio和OpenHarmony SDK已经装好,这一项应该能正常识别。如果没有识别到,多半是环境变量的问题,需要在~/.bashrc或者~/.zshrc里手动指定:
bash复制export DEVECO_SDK_HOME=/path/to/your/DevEco-Studio/sdk
export PATH=$DEVECO_SDK_HOME/ohos-toolchains:$PATH
初始化项目的时候,记得把ohos平台加上:
bash复制flutter create --platforms=ohos smart_learning
这里有个容易踩的坑:如果你不加--platforms=ohos,默认只会生成android和ios的目录结构,后面再补ohos目录会比较麻烦。生成完以后,项目根目录会出现一个ohos文件夹,里面是用ArkTS写的壳工程,Flutter业务代码还是跑在lib/下面,两边通过平台通道通信。
1.3 真机连接与RK3568设备树的选择困惑
这是我在项目里花时间最多的一个环节,也是很多刚开始玩OpenHarmony的人头大的地方。论坛里经常看到有人问“rk3568到底有多少设备树,我应该选哪个”,原因在于OpenHarmony的镜像构建和烧录不像Android那么傻瓜,设备树配置会直接影响内核能不能正确驱动你板子上的外设。
我当时用的是官方发布的RK3568标准镜像,烧录完之后用hdc list targets检查设备,结果设备是识别到了,但flutter run一直连接不上。排查了一圈发现是hdc的版本和DevEco Studio自带的hdc版本不一致导致的。DevEco Studio的SDK里有自己的hdc工具,系统PATH里如果又装了一个旧版hdc,两边会打架。
解决办法是把DevEco Studio SDK里的hdc路径放到PATH最前面:
bash复制export PATH=$DEVECO_SDK_HOME/ohos-toolchains:$PATH
hdc version
跑完flutter run -d <device-id>之后,看到那行“Flutter run key commands”的时候,我长舒了一口气。这一整套环境配置,看起来是复制两三条命令的事,实际背后是OpenHarmony工具链、Flutter引擎、设备驱动三个层面都要对齐才能跑通。
提示:如果你发现自己选错了设备树、镜像启动到一半卡死,不要浪费时间反复烧录。去确认你板子的厂商型号、DDR容量、屏幕分辨率这三个信息,再回到镜像发布页核对对应的设备树文件名,一次就能选对。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 课程详情页的数据模型与网络层:先把数据流跑通
2.1 课程详情的字段设计:比你想象的多得多
课程详情页在UI上看起来就是一块封面图、一个标题、几个简介标签、一个课程序列列表,但真正落数据模型的时候,字段数量能翻到三四十个。
我在项目里把课程详情拆成了三个子模型,避免一个类堆得过大:
dart复制class CourseDetail {
final String courseId;
final String title;
final String subtitle;
final String coverUrl;
final List<String> gallery; // 轮播图
final int originalPrice; // 原价,单位分
final int salePrice; // 售价,单位分
final int studentCount; // 学习人数
final int courseDuration; // 总时长,单位分钟
final int chapterCount; // 章节数
final String teacherAvatar;
final String teacherName;
final String teacherTitle;
final List<ChapterItem> chapters;
final bool isFavorite; // 初始收藏状态
final bool isEnrolled; // 初始选课状态
factory CourseDetail.fromJson(Map<String, dynamic> json) { ... }
}
class ChapterItem {
final String chapterId;
final String title;
final int duration;
final bool is
