阳台小花园开发手记 07|HarmonyOS 7.0 互动卡片:桌面动画中断后安静退场【共创稿事节】【鸿蒙心迹】

1. 前言
瓢虫刚从薄荷叶后探出来,用户便翻到了下一页桌面。对动画来说,这个动作有些突然;对用户来说,却再自然不过。他已经决定做另一件事,没有理由等花园完成回程。
这让我们需要重新审视“播放完成”。正常走到终点只是其中一条路径。翻页、长按、打开日记,以及另一张卡片发起动效,都可能让当前会话提前结束。如果实现只照顾正常路径,画面消失以后,传感器和计时任务可能还在工作。
工程继续沿用绑定薄荷 plant-001 的2×2桌面动态卡片。普通页面是 MintCard,激活页面是 MintLive,对应扩展仍为 MintFormAbility 和 MintLiveAbility。花盆、叶片、瓢虫、倾斜路线和日记入口都保持前篇约定。
本篇增加第二张卡片,绑定植物记录 plant-002。下文称薄荷卡片为 A,第二张为 B。两者使用同一套模板,通过绑定数据选择名称、摘要和日记目标。增加一个实例,足以暴露“当前植物”“当前订阅”这类全局变量的问题,无须另造一套工程。

我们要回答的问题是:系统拒绝或打断动画以后,当前会话怎样停止工作,而下一次用户操作又怎样正常开始?
2. 方案
最容易想到的补救,是把没播完的动画放回队列,稍后重试。这种做法把动画当成了必须完成的任务。对于观察日记,真正需要保留的是植物资料和入口。用户翻页以后,补播瓢虫没有完成新的业务目标,反而延长了资源占用。
我选择结束本次尝试。请求被拒绝,就释放请求阶段持有的资源;激活后被打断,就结束对应会话。普通态继续显示摘要,下一次用户主动操作再发起新的请求。
场景动效选择的系统背景:全局同一时刻只执行一张卡片动效,用户主动触发优先,其他刷新请求先到先得,失败不缓存。桌面点击、翻页、长按、拖动等有效操作也会打断动效。
这里有两组情况需要分开。A 播放时用户点击 B,与普通刷新请求竞争,不能画成同一种调度规则。请求失败而没有创建激活页面,与页面已经存在后被销毁,也不能共用一套“动画结束了”的解释。

第02篇的来源约定仍然有效:不能看到 onUpdateForm 就请求动画。验证刷新竞争,应使用已核实的合法触发路径,否则测到的可能是应用自己的错误分发。
正常结束仍保留第05篇的收束过程。提前退出则直接结束当前阶段,不等瓢虫走回叶后。单次申请最长3500ms,这个数值限定预算,却没有承诺完整的播放窗口。
为了判断变化来自哪里,测试时固定区域、路线、映射、阶段预算和 useDefaultAnimation 配置,只改变退出动作。B 也使用独立会话,避免共享状态把一次普通中断变成难以解释的串扰。
3. 实现
清理代码经常从一段顺序调用开始:退订传感器,停止计时器,释放引用。问题出在第一步抛出异常时,后面的步骤可能根本没有执行。
另一个问题更隐蔽:页面清理和扩展销毁都可能到达。如果第一次已经释放资源,第二次应当可以安全返回;如果第一次释放失败,第二次又不能因为一个笼统的 closed 标志而跳过所有工作。
因此,我把“失去更新资格”和“资源释放完成”分开。前者在退出开始时立即成立,后者按资源逐项记录。
interface ReleaseAction {
name: string;
release: () => void;
}
class SessionCleanup {
private active: boolean = true;
private pending: ReleaseAction[];
constructor(actions: ReleaseAction[]) {
this.pending = actions.slice();
}
canCommit(): boolean {
return this.active;
}
close(): string[] {
this.active = false;
const failed: ReleaseAction[] = [];
const errors: string[] = [];
for (const action of this.pending) {
try {
action.release();
} catch {
failed.push(action);
errors.push(action.name);
}
}
this.pending = failed;
return errors;
}
}
SessionCleanup 是应用层对象。这里的释放动作采用同步契约:正常返回代表该动作完成,抛出异常代表仍需处理。若接入的退订接口异步报告结果,就应等待其完成后再移除待清理项,不能把一个返回 Promise 的函数直接塞进这份同步实现。
资源接入层还要保证重复释放安全,并处理“动作部分完成后失败”的情况。close() 返回失败资源名,由调用者附上会话信息记录。保留失败项便于后续合法清理入口继续处理,不意味着在后台启动无限重试。

资源归属比调用位置更重要。formId 标识卡片实例,plantId 标识植物,应用自定义 runId 标识一次激活。三者解决不同问题。A 退出后,即使 B 已经开始,也只能清理 A 持有的订阅与任务。
| 资源 | 持有者 | 退出动作 |
|---|---|---|
| 传感器订阅 | 创建它的激活会话 | 按对应订阅标识或回调引用退订 |
| 渲染更新与阶段计时器 | 创建任务的页面或会话 | 停止实际句柄对应的任务 |
| 累计量、平滑状态、上一采样时间 | 当前会话 | 结束后丢弃,下次重新初始化 |
| 页面、上下文与存储引用 | 应用中的实际持有者 | 解除持有关系,避免闭包继续引用 |
| 植物资料与观察日记 | 既有持久化数据路径 | 保留,不随动效销毁 |
不要在清理函数里读取“当前订阅”再退订。这个变量可能已经指向 B。创建资源时就保存自己的释放动作,退出时沿原引用处理,才能让归属关系在时间变化后仍然成立。
退订以后,已经排队的回调仍可能到达。第04篇的会话检查因此还要保留。下面用位置更新展示这一层保护:
interface PositionSink {
update(position: number): void;
}
class SessionReceiver {
private sink: PositionSink | undefined;
constructor(
private cleanup: SessionCleanup,
sink: PositionSink
) {
this.sink = sink;
}
accept(position: number): void {
if (!this.cleanup.canCommit()) {
return;
}
const target = this.sink;
if (target !== undefined) {
target.update(position);
}
}
close(): string[] {
this.sink = undefined;
return this.cleanup.close();
}
}
每个会话创建自己的接收器,传感器回调捕获这个实例。重新激活时创建新实例,旧回调就不会因为一个全局 active 再次变为真而获得新页面的写入权。异步读取同样需要在结果提交时检查,不能只在读取开始时检查。

接下来把这些职责接到生命周期上。onLiveFormDestroy 负责对应会话的退出,页面清理处理页面持有的任务。共享资源应只有一个明确持有者,两个入口可以调用同一清理对象,但不能各自维护一份互不知情的释放状态。具体回调参数和传感器退订方式,以当前 SDK 声明为准。
主动取消使用 cancelOverflow 路径,分别记录取消请求、返回结果和实际销毁事件。调用返回不能证明全部资源已经归还。取消操作可以放在测试入口,不必改变原有日记按钮的职责。
卡片删除也要单独看。ArkTS卡片生命周期中的 onRemoveForm 处理实例数据;删除 A 不应删除植物日记,更不能清理 B 的绑定。进程异常退出则可能没有最后一条销毁日志,不能假定所有路径都按相同顺序经过清理函数。
再次进入时,仍在 onLiveFormCreate 中同步加载默认 UI,再补资料和初始化传感器。瓢虫从叶后探出,抵达既定路线起点,不恢复中断时的半截姿态。
能力不可用时,普通态负责承接用户。部分不支持情形可能返回801,应记录实际错误,而非将所有失败归为这个编号。文档还规定:省电模式不响应动效,HOT 热档位不响应非点击请求,OVERHEATED 不响应所有请求。这些限制不能直接推出模式切换时在播动画的具体退出顺序。

第三方应用不能依赖系统应用专用的 onChangeFormVisibility 或 disabledDesktopBehaviors 绕开桌面规则,也不应在普通提供方中搭建常驻传感器循环。API26 的明确新增入口仍是 triggerTypes 中的 shake,这里的生命周期职责不能一并写成7.0首发能力。
4. 检验
我会先测一次不插入操作的正常结束,取得资源基线,再逐项改变退出条件。机型、系统、SDK、工具版本、构建和配置编号随记录保存;普通卡片可用、场景动效可用、系统摇动可用分别判断。
| 条件 | 操作 | 重点观察 |
|---|---|---|
| 正常结束 | 等待本次动效结束 | 收束、销毁与资源基线 |
| 主动取消 | 在三个阶段分别取消 | 取消结果、实际退出、重复清理 |
| 桌面操作 | 分别翻页、长按、拖动 | 中断后无有效更新,返回后普通态完整 |
| 进入应用 | 点击原有日记入口 | 目标植物正确,退出不等待回程 |
| 双卡竞争 | A 激活时点击 B,再交换顺序 | 各自请求、创建与销毁,身份不串用 |
| 普通刷新竞争 | 执行已核实的刷新触发 | 失败请求不自动补播 |
| 删除卡片 | 删除活动中的 A | A 的资源与绑定清理,B 和日记保留 |
| 再次激活 | 中断后重新进入 | 新会话、新累计器、旧回调被拒绝 |
| 能力限制 | 不支持设备、省电模式分别验证 | 记录实际表现,普通态入口仍可用 |
常规有效条件各重复三次,再安排十轮“激活—中断—再次激活”,检查资源是否逐轮累积。记录每次操作与间隔,不用无限请求代替有边界的测试。温度条件不可控时保留待测,不主动让设备过热。
退出后的观察窗口提前固定,覆盖申请剩余预算及已知任务可能晚到的时段。观察由测试工具完成,不为保存日志而让卡片后台常驻。翻页后应返回原桌面页检查,离屏本身不能算白屏。
资源计数按会话观察。A 已结束而 B 仍在运行时,整个进程的订阅数未必为零;需要归零的是 A 持有的资源。总量则应与相同运行条件下的基线比较。
我会把“退订调用成功”“旧回调到达”和“旧回调提交画面”分开记录。旧回调到达后被拒绝,说明保护仍在起作用;只有提交被拦住、订阅却未释放,仍然不能算清理完成。应用计数也只能说明已经跟踪的资源,不能直接证明功耗下降。
日志需要关联操作序号、三个身份字段、请求来源、动效阶段、资源前后计数、错误和录屏编号。尚未创建会话的失败请求只关联操作编号。没有正式退出原因字段时,记录“翻页后观测到销毁”即可,不补造系统给出的原因。
再注入一次单项释放失败,检查其余动作是否继续;让资料读取晚到,检查是否修改新页面;重复调用清理,检查已释放项目是否被跳过。这些应用逻辑检查与真机中断记录分别保存。

最后回到日记入口。A 应打开 plant-001,B 应打开 plant-002,从绑定数据取值,接收端继续处理参数无效、植物不存在和空日记。实际结果与证据编号在执行后填写;缺少设备或合法触发路径的项目保留待测,文档约束单列。
5. 结尾
退出是短交互的一部分。把会话有效性、资源归属和普通态职责分别表达出来,正常结束与提前中断就可以沿同一套原则处理,同时保留各自的生命周期差异。
这也为七篇内容提供了一条回归顺序:先检查双态加载和触发来源,再核对区域、倾斜与首尾画面,随后验证日记目标,最后加入双卡竞争、各类退出和能力限制。每一步沿用同一个工程版本和资源约定。
归档时,将加载时序、触发配置、几何样本、映射参数、视觉契约、导航点位和本篇清理矩阵放在一起,关联构建、日志与录屏。设备范围和剩余待测项同样属于交付内容。
用户随时可以离开这片小花园。我们的实现需要让这次离开完成得干净,并在他回来时,继续提供那盆植物的摘要和日记。
更多推荐

所有评论(0)