1. 复盘高校通知业务:公告模块为什么值得单独做
1.1 四六级报名的通知链路与用户痛点
我在做这个项目之前,一直觉得"通知公告"就是套一个列表页、塞几个接口、上拉加载下拉刷新,工作量大不到哪去。真正跟教务处的老师聊完需求、再把四六级报名的完整流程走了一遍之后,才发现这个模块远没有想象中那么简单。
四六级考试在高校里的通知链路大概是这样的:考试院下发报名通知到学校教务处,教务处再通过官网、OA、辅导员群一层层传递,最后落到学生端。这条链路有几个天然痛点。第一,信息传递层级太多,学生看到通知的时间差很长,经常是报名已经开始了才有人知道。第二,不同院系、不同年级的学生关心的通知内容不一样——大一新生关心"我能不能报",大二大三学生关心"名额剩多少",毕业班学生关心"最后一次机会错过了怎么办"。第三,考试相关的通知往往附带大量格式复杂的文件,比如报名操作手册PDF、考场安排Excel、诚信考试承诺书,这些文件在手机端打开一直是个问题。
所以通知公告模块看似是个公用信息流,实际上是一个承担了"时效性、针对性、多格式承载"三大职责的业务模块。如果只是简单地把后台发布的文章按时间倒序排列给用户,那这个模块上线之后一定会被骂。
1.2 Flutter × OpenHarmony 组合的可行性判断
接下来说选型。这个项目比较特殊,学校内部正在推进 OpenHarmony 生态的试点,一体机、阅报屏、校园信息终端都在逐步切换。但学生端的App又不能只跑在 OpenHarmony 设备上,大量学生用的还是 Android 和 iOS 手机。于是"同一套代码,覆盖手机与国产系统终端"就成了硬性约束。
Flutter 无疑是最合适的方案。核心原因有三点:
- Flutter 的渲染引擎是自绘的,不依赖系统原生控件,理论上只要把 Engine 移植到目标平台上就能跑,OpenHarmony 的适配正好走的是这条路。
- 四六级报名系统的 UI 组件不算复杂,主要是列表、表单、富文本、图表,这些恰好是 Flutter 擅长的领域。
- 团队里已经有 Flutter 经验的成员,不需要为了 OpenHarmony 单独拉起一支原生开发队伍。
这里我想多说一句,很多人一听到"跨端"就兴奋,觉得一套代码到处跑,实际上跨端是有代价的。OpenHarmony 跟 Android 虽然都是 Linux 内核衍生系,但它们的应用沙箱、权限模型、System UI 都存在差异。比如 OpenHarmony 的通知服务走的是自己的 Notification Kit,角标逻辑跟 Android 的桌面角标实现也完全不同。所以跨端方案解决的是"UI 和业务逻辑复用"的问题,而不是"所有平台能力无脑复用"。这个认知必须在项目启动前对齐,否则后面每个平台通道的联调都会变成扯皮现场。
1.3 模块边界:通知公告不该和报名流程耦死
需求评审的时候,产品经理最初提的方案是:在报名流程页面顶部加一个"公告轮播",同时首页放一个"最新通知"入口。这个方案我直接否了。
原因很简单。四六级报名是强时效流程,每年只在特定时间段开放几个星期,页面访问量集中在报名窗口期。而通知公告是全年都有产出的模块,开学通知、缴费提醒、准考证打印、成绩公布、证书领取,每个阶段都有内容。如果把公告嵌在报名流程里,等到报名期一过,这个模块就跟着"死亡"了,后续的通知内容完全失去出口。
所以我把模块边界做了明确划分:公告通知是一个独立的、全局可访问的模块,报名流程通过"指定公告ID跳转"的方式引述公告内容,而不是把公告组件塞进报名页面。这样做的直接收益是:通知的数据源可以独立维护,后台运营可以灵活地给公告打标签、设置置顶、限定可见院系,前端不需要跟着业务方反复改代码。
这个边界划分在技术上的影响是深远的——它让我在设计数据模型时,就意识到公告不是"报名系统的附属品",而是一个拥有独立的分类体系、发布状态、接收对象范围的内容实体。后面实现的 Tab 分类、院系过滤、已读状态同步,都建立在这样一个清晰的边界前提上。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备:OpenHarmony设备适配与Flutter引擎接入
2.1 RK3568设备树的选择逻辑
开发过程中第一个让我头疼的不是 Flutter 代码,而是 OpenHarmony 的设备适配。项目里用的测试设备是 RK3568 开发板,但 RK3568 的设备树(Device Tree)在 OpenHarmony 仓库里有好几套,社区里经常有人问"到底该选哪一个"。我在这个坑里来回折腾了两三天,梳理清楚后其实逻辑并不复杂。
先解释一下背景。RK3568 是瑞芯微的一颗四核 A55 芯片,OpenHarmony 官方和瑞芯微分别维护了适配它的 kernel 与 device 配置。经常出现的有 rk3568、rk3568-mpi、rk3568-evb 等变体,它们的差异主要在开发板型号的外设配置上——网卡型号、显示屏接口、音频 Codec、USB 布局都不一样。选错了设备树,最典型的现象是:系统能开机,但网口不通、屏幕不亮或者触摸无响应。
我的建议是,不要凭文件名猜,直接用命令查板子硬件信息。在 OpenHarmony 系统启动后,执行 cat /proc/device-tree/model 可以拿到设备型号,再对照 vendor 目录下的配置进行选择。如果板子是自己公司定制的,那就要基于官方默认设备树裁剪外设节点,而不是硬套某一个现成的 dtb。
这里的核心教训是:设备树不是越新越好,而是跟硬件外设匹配才算好。社区里很多人一上来就选最新的设备树文件,结果触摸屏驱动冲突,反过来抱怨系统不稳定。其实问题出在设备树与板子外设不完全匹配。
2.2 Flutter for OpenHarmony 的版本配套
Flutter 官方目前对 OpenHarmony 的支持是通过社区 flutter_flutter 的 OpenHarmony 分支来做的,版本节奏会落后于 Flutter 主线。我当时选的是 Flutter 3.7 对应的 OpenHarmony 适配版本,Dart 版本限定在 2.19 左右。这个版本信息必须提前确认,否则后面做原生插件对接时,版本不匹配会引发各种诡异问题。
我在环境搭建时踩到最狠的一个坑,是 Gradle 插件加载方式。Flutter 的 OpenHarmony 工程第一次构建时,会触发 flutter pub get 并解析 dev.flutter.flutter-plugin-loader 插件,如果插件版本跟 Flutter 版本不匹配,会出现类似 you are applying flutter's main gradle plugin imperatively using the apply script 的报错。这行报错的字面意思很绕,但根本原因只有一个——build.gradle 里插件应用方式不对。
Flutter 主流的 Gradle 集成方式经历了两个阶段:老版本用 apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle" 这种方式,新版本则要求改用 plugins { id 'dev.flutter.flutter-plugin-loader' version '1.0.0' } 的声明式插件加载。OpenHarmony 的适配层在早期版本里同时兼容了这两种方式,但兼容逻辑有 Bug,导致新版本 Flutter 工具链在 OpenHarmony 工程里误走老路径。
解决方案也很直白:查看 ohos 工程目录下的 build.gradle,明确使用声明式插件加载,并且保证 dev.flutter.flutter-plugin-loader 的版本号在本地 Flutter SDK 的 bin/cache 中存在。如果不存在,就手动执行一次 flutter precache --ohos 之类的命令,把对应平台的基础构件拉下来。这个排查过程比较枯燥,但值得完整走一遍,因为它是 Flutter 与 OpenHarmony 工程结合的底层逻辑。
2.3 从零跑通 Flutter 空工程
环境配套理清后,跑通一个空工程是建立信心的关键步骤。我的操作路径是这样的:
