【转盘决定吧|19】HarmonyOS ArkTS 回归测试实战:覆盖启动、空数据、异常输入和重复点击
转盘决定吧的核心交互看起来并不复杂:抛一枚硬币、摇几颗骰子,或从题库里抽一个结果。但这类轻量工具最容易在上架前被低估。真正影响首轮体验的,往往不是随机算法,而是首次启动时本地存储尚未就绪、页面参数缺失、题库为空、动画过程中连续点击,以及窗口宽度变化后状态是否还能保持一致。
本文以转盘决定吧 1.0.9 的真实工程为样本,面向 HarmonyOS 5.0+ 的稳定性回归视角梳理测试方法。这里的“面向”表示文章的回归标准与上架稳定性场景相匹配,并不据此替源码声明未核实的 SDK 编译版本。工程包名为 com.jiaweikang.one4,module.json5 声明了 phone、tablet、2in1 三类设备,也注册了窗口断点系统;因此回归不能只在一台手机上点通一次。

先把“能打开”拆成可回归的结果
一次启动成功,不等于产品具备可提交的稳定性。对这个工程而言,至少要把结果拆成下表四类:
| 回归面 | 真实代码入口 | 需要确认的结果 | 常见漏测后果 |
|---|---|---|---|
| 启动与恢复 | EntryAbility.onCreate、onWindowStageCreate | 首屏可见,初始化失败不会白屏 | 偏好数据异常后卡在启动页 |
| 首次与空数据 | Index.aboutToAppear、FunDetail.aboutToAppear | 引导、默认路由与空题库有明确反馈 | 首次打开或异常参数出现空白页 |
| 动画中的重复操作 | Coin.flip、Dice.roll、FunDetail.startPick | 忙碌期间不重入,结束后状态收束 | 多次写历史、结果闪烁、控件错位 |
| 窗口与设备变化 | BreakpointSystem、Tabs | 断点、底部标签和当前页保持可用 | 折叠、平板或 2in1 宽度变化后布局失效 |
这四类不是测试术语的堆砌,而是由工程现有边界反推出来的。发布前最有价值的回归,是让每一条代码里的保护条件都拥有一个可复现的输入和一个肉眼可确认的输出。
现有 Hypium 用例为何不能代表业务覆盖
工程已经存在 entry/src/test/LocalUnit.test.ets 和 ohosTest 的 Ability 用例,但当前内容只是框架生成的字符串断言:
it('assertContain', 0, () => {
let a = 'abc';
let b = 'b';
expect(a).assertContain(b);
expect(a).assertEqual(a);
});
它能说明测试环境被接入,却不会触及启动初始化、随机结果、历史写入或按钮去重。把这种默认用例当成“已测”,在 AppGallery 稳定性检查里没有实际价值。
更稳的做法是把测试分层:纯逻辑放到 Hypium,涉及路由、动画、窗口和权限的流程放到设备或模拟器回归清单。两者都有证据,才不会出现“单测绿了,首屏还是白的”这种错位。

启动链路:先验证降级,而不是只等初始化成功
EntryAbility.onCreate 会依次保存应用上下文、初始化 Preferences、加载设置/历史/转盘、应用主题并初始化音效。这里使用 try/catch 记录异常,因此启动测试的关键不是断言所有服务必然成功,而是确认任一初始化环节异常时,窗口是否仍能加载 pages/Index。
async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): Promise<void> {
try {
AppStorage.setOrCreate('appContext', this.context.getApplicationContext());
await PreferencesStore.init(this.context);
const settings = await SettingsService.load();
await HistoryService.load();
await WheelService.load();
SettingsService.applyTheme(settings.theme);
await SoundService.init();
} catch (error) {
hilog.error(DOMAIN, TAG, 'service init failed: %{public}s', JSON.stringify(error));
}
}
onWindowStageCreate(windowStage: window.WindowStage): void {
BreakpointSystem.register();
windowStage.loadContent('pages/Index', (err) => {
if (err.code) return;
});
}
这段代码的边界很清楚:初始化错误被记录后不再向上抛出,窗口创建仍尝试加载首屏。相应的回归用例要分别构造“首次安装”“保留旧 Preferences 升级”“Preferences 中 JSON 损坏”三种环境,观察 Index 是否出现、是否能进入任意功能页,并保留 EntryAbility 的日志作为问题定位证据。
把启动回归写成可复用的设备步骤
启动类场景很难完全依赖 UI 单测,但步骤必须有固定断言,否则每次验证都会变成随手点几下。
| 编号 | 前置状态 | 操作 | 通过条件 |
|---|---|---|---|
| S01 | 新安装,无本地数据 | 冷启动 | 出现四步引导,不白屏、不闪退 |
| S02 | 已完成引导 | 杀进程后再次启动 | 直接进入主界面,不重复出现引导 |
| S03 | 写入不可解析的偏好值 | 冷启动 | 页面仍能进入,使用默认状态,不因 JSON 解析中断 |
| S04 | 启动后旋转/调整窗口 | 等待首屏稳定 | 当前标签可点击,内容没有遮住底部标签 |
PreferencesStore.getJson 恰好给了 S03 一个明确预期:解析失败时返回传入的默认值并记录 warning,而不是把异常传给 UI。
static getJson<T>(key: string, def: T): T {
const raw = PreferencesStore.getString(key, '');
if (!raw) return def;
try {
return JSON.parse(raw) as T;
} catch (e) {
hilog.warn(0, TAG, 'parse json failed key=%{public}s', key);
return def;
}
}
测试人员不需要检查 catch 是否写在代码里;应检查损坏数据发生后默认页是否可继续使用。这才是用户实际感受到的恢复能力。
首次打开:引导开关要覆盖两条分支
Index 使用 onboarding_done_v1 控制引导层显示。键不存在时默认值为 '0',所以首次启动出现引导;完成或跳过后通过 putString 持久化为 '1'。
aboutToAppear(): void {
this.showGuide = PreferencesStore.getString(ONBOARDING_DONE_KEY, '0') !== '1';
}
private async finishGuide(): Promise<void> {
this.showGuide = false;
this.guideStep = 0;
await PreferencesStore.putString(ONBOARDING_DONE_KEY, '1');
}
回归时至少覆盖“逐步完成”“第 1 步跳过”“完成后重启”三条路径。特别要验证跳过按钮和最后一步按钮得到同样的持久化结果。仅验证前者能隐藏遮罩,不足以保证第二次启动不会重新弹出。
窗口断点:多设备不是只测三个尺寸截图
工程在窗口阶段注册 BreakpointSystem,用 mediaquery 将宽度写入 AppStorage('currentBreakpoint'):sm 小于 600vp,md 为 600vp 至 840vp,lg 为 840vp 以上。销毁窗口时又解绑监听。
BreakpointSystem.mdListener = mediaquery.matchMediaSync('(600vp<=width<840vp)');
BreakpointSystem.mdListener.on('change', (result) => {
if (result.matches) {
AppStorage.set<string>('currentBreakpoint', 'md');
}
});
static unregister(): void {
if (BreakpointSystem.smListener !== null) {
BreakpointSystem.smListener.off('change');
}
}
因此设备回归要把窗口变化当作连续过程:在 sm 打开首页,拖动或切换到 md、lg,再回到 sm;每次都确认当前标签、引导遮罩和页面按钮仍可操作。单独截三张静态图,无法发现监听器重复注册或边界切换瞬间的状态残留。

抛硬币:重复点击用状态与控件双重拦截
Coin 同时在业务入口与按钮配置中使用 flipping。入口的 if (this.flipping) return 防止任何重复调用进入动画;按钮的 disabled 则给用户明确的不可操作状态。
PrimaryButton({
label: this.flipping ? '抛出中…' : '抛硬币',
disabled: this.flipping,
onPress: () => this.flip()
});
private flip(): void {
if (this.flipping) return;
this.flipping = true;
this.result = '';
// 动画结束后才恢复输入并写入一条历史
animateTo({ duration: 2000, onFinish: () => {
this.flipping = false;
HistoryService.add('coin', '抛硬币', result);
}}, () => { this.angle = target; });
}
这里应设计“1 秒内连续点击 10 次”的设备用例。通过条件不是只看到动画,而是结束后只生成一次结果、只写入一条对应历史,按钮文案恢复为“抛硬币”。同时把震动开关关闭后再执行一次,确认附加反馈失败或关闭不会阻断随机结果。
骰子:忙碌期间既不能摇,也不能改数量
骰子页的风险比硬币多一层:摇动过程中若切换 1/2/3 颗骰子,values 数组和最终 finalVals 可能不同步。源码已经对两类入口都检查 rolling。
.onClick(() => {
if (this.rolling) return;
this.count = n;
this.values = new Array<number>(n).fill(1)
.map((_, i) => this.values[i] ?? RandomUtil.int(6) + 1);
});
private roll(): void {
if (this.rolling) return;
this.rolling = true;
// 16 次临时数字刷新结束后才落定 finalVals
if (i >= total) {
this.values = finalVals;
this.rolling = false;
this.recent = [text].concat(this.recent).slice(0, 8);
HistoryService.add('dice', this.count + ' 颗骰子', text);
}
}
建议把测试脚本拆成两个断言:第一,连续点“摇一摇”不会得到两次历史;第二,在“摇骰子…”期间点数量标签,最终骰子颗数和合计仍来自同一次 finalVals。后者能够直接拦住动画状态与可交互控件脱节的问题。
趣味抽取:参数缺失和题库为空不能混为一谈
FunDetail 对路由参数提供了默认值:key 缺失回退到 eat,标题回退到“今天吃什么”。但题库是否能返回元素,是另一个独立条件;按钮把 this.bank.length === 0 纳入 disabled 判断。
aboutToAppear() {
const params = router.getParams() as RouteParams;
this.bankKey = params?.key ?? 'eat';
this.title = params?.title ?? '今天吃什么';
this.bank = FunQuestionBank.get(this.bankKey);
this.current = '?';
}
PrimaryButton({
label: this.picking ? '抽取中…' : (this.result ? '再来一题' : '开始抽取'),
disabled: this.picking || this.bank.length === 0,
onPress: () => this.startPick()
});
测试要分别覆盖缺参和非法 key:缺参应能落到默认“吃什么”题库;非法 key 若返回空数组,按钮应禁用且页面不崩溃。不要把“页面有默认标题”误判成“题库已兜底”,两者的证据不同。
反馈页:输入校验和“发送”语义要分开核验
反馈页将提交按钮禁用于空内容或 sending 状态,动画完成后 toast “感谢反馈!”并返回。当前代码未见网络请求或本地持久化调用,因此回归报告应把它记为“交互完成”,而不是“反馈已送达”。
private submit(): void {
if (this.sending || this.content.trim().length === 0) return;
this.sending = true;
setTimeout(() => {
animateTo({ duration: 800, onFinish: () => {
promptAction.showToast({ message: '感谢反馈!' });
setTimeout(() => { router.back(); }, 400);
}}, () => { this.planeOpacity = 0; });
}, 250);
}
对应的回归断言是:空白或全空格文本不能触发动画;输入有效文本后按钮进入发送中,最终返回上一页;再次进入反馈页输入框是初始状态。若产品要承诺“已提交给开发者”,则必须另行补充真实传输、失败反馈与隐私说明,不能通过测试文案掩盖实现缺口。
历史写入:检查上限与 UI 镜像是否一致
随机结果最终会进入 HistoryService.add。服务先写入 AppStorage 镜像,再持久化到 Preferences,并将记录截为最多 500 条。这意味着回归除了看“历史页有内容”,还要观察新增后的即时刷新、杀进程后的恢复和删除后的同步。
static async add(type: HistoryType, title: string, result: string): Promise<void> {
const record = new HistoryRecord();
record.id = RandomUtil.id('h');
record.type = type;
record.title = title;
record.result = result;
record.timestamp = Date.now();
const next = [record, ...HistoryService.getAll()].slice(0, 500);
AppStorage.setOrCreate<HistoryRecord[]>(HistoryService.STORAGE_KEY, next);
await PreferencesStore.putJson<HistoryRecord[]>(KEY, next);
}
建议将“完成一次硬币/骰子/趣味抽取后进入历史”“清空后退回首页再进入”“重启后检查最后一次记录”列为固定回归项。500 条边界可以在调试环境用预置数据构造,验证第 501 条加入后最旧数据被截掉,而不是导致列表增长失控。
可落地的 Hypium 测试:先测纯规则
页面动画与系统 Ability 适合设备回归;纯规则则可以马上补进 Hypium。下面的示例刻意把“按钮能否再次触发”的判断抽成可测试函数,接入项目时应放在业务服务或独立工具模块,而不是复制一份页面状态。
export function canStartRandomAction(isBusy: boolean, optionCount: number): boolean {
return !isBusy && optionCount > 0;
}
describe('random action guard', () => {
it('blocks repeated actions and empty banks', 0, () => {
expect(canStartRandomAction(true, 3)).assertFalse();
expect(canStartRandomAction(false, 0)).assertFalse();
expect(canStartRandomAction(false, 3)).assertTrue();
});
});
该用例不替代页面测试,它只锁住最容易回归的布尔规则。随后在设备流程中验证 flipping、rolling、picking 与按钮 disabled 是否真正接上这条规则,才能形成从逻辑到体验的闭环。
上架前执行顺序
把所有场景一次性塞给测试人员,通常只会得到一份打勾表。更有效的顺序是先验证启动阻断项,再验证高频交互,最后做窗口和恢复回归。
- 新安装与已安装升级各冷启动一次,观察日志和首屏。
- 完成/跳过引导后重启,确认本地开关持久化。
- 分别对硬币、骰子、趣味抽取执行 10 次连续点击。
- 在骰子动画中点击数量,在抽取页传入缺失参数与空题库。
- 产生历史、清空历史、重启后复查本地数据。
- 在
sm、md、lg三个断点间连续切换,检查标签与按钮可达性。 - 关闭震动或让系统振动调用失败,确认核心随机结果仍会落定。
其中第 7 项有源码依据:Haptic.vibrate 在同步异常和异步失败时只记 warning,不向页面抛出。因此测试的预期应是“结果仍出现”,而不是强行要求每台设备都产生触感。
常见失败现象与定位顺序
| 现象 | 优先检查 | 源码依据 | 修复方向 |
|---|---|---|---|
| 启动后白屏或首屏缺数据 | EntryAbility 初始化日志、loadContent 回调 | 初始化与窗口加载分为两个 try/callback 边界 | 分开记录服务失败和页面加载失败 |
| 硬币一次操作生成多条记录 | flipping 是否过早复位 | 历史写入在动画 onFinish 中 | 保持入口守卫到最终落定 |
| 骰子数与合计对不上 | 摇动时是否允许改 count | 数量切换与摇动都依赖 rolling | 禁用并在入口 return 双重保护 |
| 趣味页只有标题没有结果 | 路由默认值与题库结果是否混淆 | 参数有默认值,题库可为空 | 为空题库提供明确不可用提示 |
| 反馈显示成功但没有可追踪记录 | 是否误把动画当成送达 | 页面没有网络/持久化调用 | 修改文案或补齐真实提交链路 |
源码事实与建议实现的边界
为了避免把测试设计误读为当前工程已经通过的回归结果,下面用“启动与交互回归覆盖边界标记”逐项区分源码事实、可观察风险和建议测试。
| 观察项 | 当前源码事实 | 本文建议实现或验证 |
|---|---|---|
| 现有测试资产 | LocalUnit.test.ets 与 ohosTest/Ability.test.ets 都只有框架生成的字符串包含与相等断言,没有调用业务服务或页面 | 先把随机守卫、上限裁剪和参数归一化提取为纯函数,再补 Hypium 单元测试;页面交互仍需设备测试 |
| 启动链路 | EntryAbility.onCreate() 依次初始化 Preferences、设置、历史、转盘和音效,异常会记录日志;onWindowStageCreate() 另行注册断点并加载 pages/Index | 分别注入服务初始化失败与内容加载失败,确认首屏、日志和可恢复路径;当前源码并没有可直接注入这些故障的测试接口 |
| 硬币重复点击 | Coin.flip() 在入口检查 flipping,按钮也绑定 disabled: flipping;历史写入位于主动画完成回调 | 设备上连续点击并核对只生成一个结果和一条历史,同时覆盖页面退出、动画中断和恢复后的状态收束 |
| 骰子重复点击 | Dice.roll() 检查 rolling,按钮禁用;数量切换也在点击回调中检查 rolling,最终结果和历史在定时刷新结束时写入 | 在动画期间同时点击摇动和数量选项,核对骰子数、合计、最近记录与持久化历史一致 |
| 趣味题库 | FunDetail.aboutToAppear() 为缺失路由参数提供 eat 和“今天吃什么”默认值;按钮在题库为空时禁用,但 startPick() 自身只检查 picking | 分开测试未知 key、空题库和重复点击;建议入口同时检查空题库,形成控件禁用与方法守卫双层保护 |
| 反馈页 | 空内容时按钮禁用,submit() 也检查空内容和 sending;提交过程只有动画、Toast 与返回页面 | 回归应验证“未发送”的真实语义,不能把动画完成当作网络送达;在线提交属于尚未实现的产品能力 |
| 历史上限 | HistoryService.add() 将新记录放在数组首部并通过 slice(0, 500) 限制上限,同时更新 AppStorage 和 Preferences | 以 499、500、501 条边界验证顺序、上限和重启恢复,并检查异步写入失败时 UI 镜像是否可能先行变化 |
| 断点与设备 | BreakpointSystem 定义 sm(<600vp)、md(600~840vp)、lg(>=840vp),注册时立即写入当前断点,窗口销毁时注销监听 | 在真实窗口跨越边界时检查断点和页面状态,不应把三张静态截图当成完整多设备回归 |
| 触觉降级 | Haptic 对同步异常和异步失败只记录 warning,不向页面抛出 | 让振动不可用时重复执行核心流程,预期仍产生结果;这条预期来自源码设计,不代表本轮已做真机故障注入 |
本轮工作读取并核对了指定页面、EntryAbility、Hypium 占位用例、历史服务、断点系统与触觉封装,完成文章精修、配图生成和本地文章检查。本文没有在本轮执行工程构建、Hypium 测试、模拟器或真机回归、连续点击脚本、故障注入、多窗口切换、安装启动卸载冒烟,也没有实现文中示例的纯规则函数。因此,文中的用例、次数和预期是可执行测试设计,不是当前版本已经通过的测试报告。
结语
这个工程最值得保留的回归思路,不是给每个页面补一堆截图,而是围绕状态边界建立可重复的检查:启动初始化可以降级,输入为空时按钮不可用,动画期间入口不重入,窗口变化能更新断点,本地数据写入后可恢复。把这条链路固定下来,转盘决定吧的每一次功能调整都能在上架前更早暴露稳定性问题。
更多推荐



所有评论(0)