提词器这个品类,说起来不算复杂,但真正动手做的时候会发现细节多到能写一本书。我这次用 Flutter 做了一个跨平台提词器 APP,核心目标就是一套代码跑通 Android、iOS,同时把鸿蒙也带上。选 Flutter 的原因很直接:我在乎的是滚动性能和 UI 自由度,而且 Flutter 的动画管线对这类字幕滚动场景非常友好。花了两周时间,从环境搭建到鸿蒙 HAP 打包都走了一遍,过程中踩了不少坑,尤其是鸿蒙工具链那一段,网上的资料又散又旧。这篇文章就把完整流程和中间的关键决策拆开讲,想用 Flutter 做提词器、想接触鸿蒙适配的开发者都能直接参考。
1. 项目整体设计与技术选型考量
1.1 为什么用 Flutter 做提词器
做提词器 APP,第一需求就是字幕滚动流畅。如果滚动卡顿,哪怕是偶尔掉一两帧,录制素材就会废掉。我评估过原生开发和跨平台方案,最终选 Flutter,核心原因有三个。
第一,Flutter 的渲染引擎是自绘的,不依赖系统原生控件。字幕滚动本质上是文本在视口中做垂直位移,Flutter 的 AnimationController 配合 SingleChildScrollView 或者自定义 CustomPainter,可以做到每帧都精确控制偏移量,性能体验非常稳定。我在 Android 低端机上实测过,即使字号调到 48、滚动速度拉满,帧率依然能稳定在 60 左右。
第二,UI 自由度确实高。提词器的外观控制非常多,比如文字颜色、背景透明度、镜像模式、滚动手势反向,这些在原生里东改一块西改一块很麻烦,在 Flutter 里就是一个 Transform.scale、一个 Container 颜色参数的问题。尤其镜像模式,短视频创作者站在镜头前,需要看到左右翻转的提词内容,这在 Flutter 里只是 scaleX: -1 一行代码,体验极好。
第三,也是我个人的偏好,状态管理简单。提词器的业务状态其实不多:当前文本、滚动位置、播放速度、字号、颜色。我用 Provider 加上一个轻量级模型就够用,不需要引入重型框架。Flutter 的 setState 在页面局部刷新时也足够快,只要别在滚动时频繁重建大组件就行。
1.2 为什么考虑鸿蒙,以及当前的生态状态
鸿蒙装机量这几年增长很快,很多做工具类 APP 的团队已经把“适配鸿蒙”从加分项变成必选项。提词器这种轻量工具,用户换机的成本很低,如果鸿蒙用户打开应用商店发现没有适配版本,很可能转头就用竞品。
Flutter 官方目前对鸿蒙的适配还在推进中,但社区已经有一套成熟方案:OpenHarmony 的 SIG 组维护了一个 flutter_flutter 的 ohos 分支,基于 Flutter 3.22 版本。这个分支在 flutter/physics、flutter/engine、flutter/packages 三件套上都做了一层适配,开发者只需要把本地 Flutter SDK 切换到这个分支,再配合 DevEco Studio 工具链,就能把 Flutter 项目构建成鸿蒙的 HAP 包。
我在实际使用中发现,这个分支的完成度已经能在生产环境里跑业务了。虽然偶尔会遇到某个插件不支持 ohos 平台,但核心的 dart:ui、widget 层都很稳定。对于提词器这种主要用基础组件的 APP,适配鸿蒙的边际成本很低,我这次真正写鸿蒙相关代码的时间,加起来不到一天。
1.3 提词器核心需求拆解
做产品之前先把需求拆清楚。我想做的不是那种最简陋的“白底黑字往上滚”的页面,而是要达到“开箱能用”的体验。所以功能清单拆成了以下四块。
文本管理模块:支持手动输入、粘贴文本,以及从本地 TXT 文件导入。提词器用户经常有现成的讲稿,导入效率比手打高一个量级。导入后要支持编辑、保存、清空,并且自动保存到本地,防止 APP 被杀后丢内容。
播放控制模块:开始、暂停、继续、重置,这是基本功。还要支持速度调节,速度单位我用“字/分钟”,而不是模糊的“快/慢”档位,因为用户需要知道自己每分钟大约能读多少字。提供 50 到 600 字/分钟的调节范围,步进为 10 字/分钟。
外观调节模块:字体大小、文字颜色、背景透明度、滚动方向(正向和镜像)。透明度调节非常关键,很多提词器是架在手机旁,背景半透明可以让用户看到镜头后的场景,这个功能在短视频拍摄时尤其常用。
辅助功能模块:倒计时三秒再开始滚动,给用户一点准备时间;屏幕常亮,避免录制过程中自动锁屏;还有一键暂停的浮层按钮,录制中遇到突发情况能快速停下。
1.4 技术选型速览
| 模块 | 选型 | 说明 |
|---|---|---|
| UI 框架 | Flutter 3.22 ohos 分支 | 一套代码跑 Android/iOS/鸿蒙 |
| 状态管理 | Provider 6.x | 轻量,满足提词器需求,团队新人也易上手 |
| 本地存储 | shared_preferences + path_provider | 存储设置项,读写临时文件 |
| 文件导入 | file_selector | 支持多端选择 TXT 文件 |
| 屏幕常亮 | wakelock_plus | 跨端,API 简单 |
| 路由 | Navigator 2.0 | 页面少,不需要引入 go_router |
这套组合的好处是依赖极少,插件越少,鸿蒙适配时的排错成本就越低。我原本想用 get_it 做依赖注入,后来发现提词器的工程复杂度根本不需要,反而增加理解成本,果断砍掉。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境搭建:Flutter SDK 与鸿蒙工具链配置
2.1 标准 Flutter 环境安装
开始之前先把标准 Flutter 环境装好。如果你不是从零开始,可以跳过这一节直接看 2.2。
从
