
1. 前言
站在玄关打开"随手备忘录"时,我通常只看三件东西:钥匙、工牌、雨伞。物品图鉴有它的用途,但这一刻,我并没有打算翻开它。
界面可以把两个动作分得很清楚,代码却未必如此。首页为了取得一个公共定义,导入了公共入口;公共入口又导出了图鉴;图鉴模块在顶层创建对象,对象的构造器顺手读取主题偏好。用户只打开清单,程序却可能已经开始准备图鉴。
这条依赖链值得检查。上一篇把当前清单读取放进实际启动准备,解决了业务缓存可能陈旧的问题。现在还要向调用者背后追一层:读取是否藏在模块加载过程中?
我们继续使用同一个手机Stage应用,一个entry模块、一个主UIAbility,保留通勤与运动模板、勾选保存、主题偏好和静态物品图鉴。图鉴按需打开,这是产品行为;图鉴是否按需加载,则是实现需要保证的边界。
本篇沿用记录B:dataVersion为2,钥匙已勾选,工牌和雨伞未勾选。勾选以最近一次成功保存为准,不按日期重置,也不表示手机知道物品是否真的装进了包。
我想弄清楚的是:怎样让首页只承担它需要的加载工作,同时不让用户第一次打开图鉴时付出难以接受的等待。
2. 方案
先把依赖画出来,比立即替换import更有帮助。从AbilityStage、主UIAbility和首页入口向下追踪,记录直接导入、公共入口再导出,以及每个模块继续依赖的内容。
源码关系告诉我们哪些模块可能被带入,构建产物和运行记录才能说明实际加载了什么。不能看到一个公共导出文件,就断言它的所有导出都产生了运行成本。

这里有三种值得比较的安排。
| 安排 | 加载边界 | 需要承担的代价 |
|---|---|---|
| 全量静态导入 | 保留首页到图鉴的静态依赖 | 可能让启动承担暂时不用的模块工作 |
| 图鉴按需导入 | 用户进入图鉴时再加载相关内容 | 首次进入图鉴需要等待 |
| 首屏必要模块前置 | 在按需图鉴基础上,将合适的必要模块纳入快启初始化 | 需要核对普通启动成本与实际复用行为 |
第三种安排有严格的范围。它考虑的是原本就在启动路径上、首屏必需、没有风险操作的模块。图鉴既然属于用户后续动作,就不能为了增加快启复用内容,又被搬回启动路径。
我会先拆除隐式业务副作用,再比较加载位置。否则,一组读取偏好,另一组没有读取,测出的差异就同时混入了业务行为变化和模块加载变化,难以解释。
三组保留相同的清单B、图鉴条目、图片资源、主题条件、存储适配器和页面绑定。不添加大文件或额外计算来放大结果。这个清单应用本来就轻,收益有限也是有效结论。
默认选择图鉴按需导入。至于必要模块是否值得前置,要等依赖与成本记录给出理由;没有合适的对象,就不增加这一层安排。
3. 实现
应用快启从API24开始提供,快启点内包含AbilityStage模块加载、onCreate和UIAbility模块加载。模块加载期间,顶层代码、类静态初始化等工作可能随之执行。
API26新增的是异步准备回调,并不是动态导入或快启基础机制。本篇继续使用26.0.0基线。
最容易漏掉的读取,往往没有出现在生命周期方法里。考虑这样的封装:
typescript
interface PreferenceReader {
readTheme(): Promise<string>;
}
class CatalogSession {
readonly initialTheme: Promise<string>;
constructor(reader: PreferenceReader) {
this.initialTheme = reader.readTheme();
}
}
// 若在模块顶层执行,构造就会发起读取。
// export const catalog = new CatalogSession(preferenceReader);
调用者看见的是一个图鉴对象,构造器却已经访问外部状态。即使把页面里的调用挪到正确位置,这次读取仍然由模块求值触发。
同样的检查要覆盖静态字段、静态代码块和单例。它们的共同问题是:业务工作的执行时机由隐含依赖决定,而调用者不容易看出来。
| 检查位置 | 需要追问的内容 |
|---|---|
| 顶层表达式与顶层实例化 | 是否读盘、注册监听或建立有状态资源 |
| 静态字段与静态代码块 | 是否缓存当前清单、主题等可变值 |
| 公共导出入口 | 首页是否为了一个小定义带入整个功能 |
| 构造器与单例 | 再次调用是否仍返回初始化时的旧Promise |
"静态图鉴"只说明内容固定。承载图鉴的对象仍可能读取偏好,因此这个名字不能替代副作用审计。
我的处理方式是把纯定义、内容取得和展示状态分开。首页使用的模板定义不再经图鉴入口导出;图鉴模块只提供内容,由打开动作决定何时调用。
typescript
// CatalogTypes.ets:只放图鉴的数据契约。
export interface CatalogEntry {
id: string;
title: string;
description: string;
}
typescript
// CatalogContent.ets:不读取用户清单或主题偏好。
import { CatalogEntry } from './CatalogTypes';
export function createEntries(): CatalogEntry[] {
return [
{ id: 'key', title: '钥匙', description: '出门前确认随身携带。' },
{ id: 'badge', title: '工牌', description: '通勤时确认是否需要。' },
{ id: 'umbrella', title: '雨伞', description: '按当天出行需要准备。' }
];
}
这些图鉴字段独立于清单的id、label、checked。图鉴描述物品,不保存"已经带上"的状态,也不改变SavedChecklist、ReadyModel中的dataVersion。
打开入口通过动态导入取得内容:
typescript
import { CatalogEntry } from './CatalogTypes';
export async function loadCatalog(): Promise<CatalogEntry[]> {
const content = await import('./CatalogContent');
return content.createEntries();
}
纯类型模块即使保留为依赖,也不应附带业务读取。更关键的是,首页其他路径不能仍然静态导入CatalogContent,否则新增一个动态入口并没有建立完整的延后边界。
这里的函数返回内容,主题则由图鉴页面消费应用当前提供的值,不再由图鉴对象在构造时读取。本篇固定主题条件,环境变化的同步留到后续讨论。

延后加载也把失败带到了交互路径上。打开动作需要表达加载中、成功和失败,并处理用户在等待期间返回首页的情况。
下面的控制器集中管理这段交互。CatalogView是页面适配边界,负责显示状态;它不负责读盘或修改清单。
typescript
interface CatalogView {
loading(): void;
show(entries: CatalogEntry[]): void;
failed(): void;
close(): void;
}
class CatalogController {
private generation: number = 0;
private busy: boolean = false;
constructor(private view: CatalogView) {}
async open(): Promise<void> {
if (this.busy) {
return;
}
const request = ++this.generation;
this.busy = true;
this.view.loading();
try {
const entries = await loadCatalog();
if (request === this.generation) {
this.view.show(entries);
}
} catch {
if (request === this.generation) {
this.view.failed();
}
} finally {
if (request === this.generation) {
this.busy = false;
}
}
}
close(): void {
++this.generation;
this.busy = false;
this.view.close();
}
}
页面返回或销毁时调用close(),加载期间禁用重复打开。代次检查使旧请求不能重新打开已经关闭的图鉴,也不能清除新请求的忙碌状态。它没有取消底层模块加载,只是撤销了旧请求更新页面的资格。
失败后可以再次发起打开,但这不保证所有错误都能靠重试恢复。尤其是模块求值失败,运行时可能保留失败状态,需要在目标环境核对。页面应保留返回清单的出口,不能让图鉴故障阻断已经可用的清单。

模块缓存与业务缓存也应分开理解。重复打开可能复用已经加载的代码,而当前主题、模板选择和勾选不能因此永久缓存。图鉴第一次打开和第二次打开需要分别记录。
清单准备入口保持原样:
typescript
async onAboutToCreateAbilityAsync(): Promise<void> {
await startup.prepare();
}
startup.prepare()继续负责当前模板、保存记录以及前两篇的失败出口和提交隔离。图鉴不加入它的必要等待列表,页面也不再读取第二遍清单。
AbilityStage接口异步回调返回的Promise成功resolve后,后续生命周期才继续;同时实现同步与异步版本时,仅异步版本生效。不能把这个等待保证套在onCreate()中任意发起的异步导入上。评估模块前置时,必须记录其实际完成位置。

本次链路不需要引入Native库。对于已有so的工程,constructor同样需要检查,但它不改变上述职责划分。
4. 检验
重构应先通过正确性检查,再进入性能比较。图鉴加载更晚,如果同时让清单变旧,就没有讨论收益的基础。
每轮恢复记录B,固定设备、SDK、OS构建、DevEco版本、签名、构建类型、主题和日志设置,用实验ID关联输入、跟踪文件与录屏。不同构建分别建立初始化条件,不假设安装更新后仍保留上一组快启结果。
普通冷启动的操作顺序如下:
- 按记录的方式结束进程并重新启动,保留启动分类依据。
- 暂不进入图鉴,观察首页框架、清单可读和首次有效勾选。
- 第一次打开图鉴,记录点击、加载开始、内容可见和可交互。
- 返回首页后再次打开,单独记录重复进入的表现。
在支持的普通冷启动场景中,用Load ETS Files核对实际加载文件,再结合Evaluate、调用栈和源码追查成本。文件自身与依赖耗时应按工具定义解释,不能把重叠区间重复相加。
Launch工具边界:当前不支持应用预加载和应用快启的完整启动分析。因此,快启检验需要独立记录路径和执行行为。缺失泳道意味着这里没有对应分析数据,不能填写为零耗时。
快启开关设置成功也不能证明命中。使用onLaunchFromHyperSnap等路径证据分类;证据不足时保留未分类样本,不自动算作普通启动。只有实际复用与模块执行记录相互对应,才能讨论前置安排的效果。
除了顺利打开,还要覆盖以下路径。
| 用例 | 检查内容 |
|---|---|
| 只看首页 | B正确展示,图鉴未意外进入必要等待,清单只准备一次 |
| 加载期间连续点击 | 不重复发起同一轮准备 |
| 加载期间返回,再次打开 | 旧结果不抢占当前页面 |
| 图鉴准备失败 | 显示失败入口,保存记录不变,仍可返回清单 |
| 保存后重开 | 沿用03的A到B脚本检查数据新鲜度 |
| 首次无数据、空清单、读取失败 | 保留各自的页面含义,不被重构合并 |
故障注入用于检查错误处理和执行顺序,单独运行。人为延时不进入性能统计;准备函数拒绝,也不能被描述成已经复现了模块导入故障。

成本记录至少保留首页可读时间、图鉴首次打开时间、再次打开时间、内存观察值与采样时点、实际模块加载和证据位置。导入完成、页面绑定和真正上屏是不同事件,日志与视频未经对齐不能直接相减。
多轮结果应保留波动,而不是只挑最快一次。如果首页几乎没有改善,图鉴首次进入却明显变慢,就需要重新评估拆分粒度。如果前置安排拖慢普通启动,也应撤回。加载位置是一项可以调整的设计选择,不必成为必须证明成功的结论。
5. 结尾
物品图鉴的加载问题,要求我们把一条模糊的依赖拆成几个可观察的决定:哪些定义属于首页,哪些行为会访问外部状态,哪些工作应由用户动作触发。
对"随手备忘录",可以把放置规则收在一张表里。
| 内容 | 放置位置 | 判断依据 |
|---|---|---|
| 首页必要的纯定义 | 首页依赖,可评估安全前置 | 没有隐式业务操作 |
| 当前模板与保存记录 | 实际启动准备服务 | 需要最近一次成功保存的数据 |
| 静态图鉴内容 | 图鉴打开入口 | 不属于首页必要信息 |
| 图鉴展示使用的主题 | 消费当前应用状态 | 不能沿用构造时缓存的旧偏好 |
导入依赖图、顶层副作用清单和双路径成本记录,分别回答"带进来什么""执行了什么""用户在哪里等待"。三者放在一起,才能判断一次模块拆分是否合适。
接下来,显式准备函数之间还存在顺序:存储打开后才能读清单,纯模板处理却可能独立进行。下一篇沿这条依赖讨论简单异步函数与AppStartup任务组织;图鉴仍留在用户打开它的那条路径上。