HarmonyOS 6 启动回调实测:同一个窗口,怎样分清 onCreate 和 onNewWant
配套工程源码、测试材料与运行说明
前言 我把三次启动留在同一张时间线上。第一轮的 PID 是结束旧进程后取得的,记录里有窗口创建和页面加载。第二轮、第三轮,窗口又出现了,进程号却没变化,记录里只追加了两条 onNewWant。光看窗口动画,有些差异会被漏掉。接下来先找 PID 对应的日志,再看代码里是谁在这些位置写下一条事件。
一次新进程,两次已有实例唤起
本次用 MateBook Pro API 24 模拟器。第一轮将应用进程结束后启动,PID 改变。页面能找到 onCreate、onWindowStageCreate、onForeground、loadContent OK、aboutToAppear 和 onDidBuild。第二轮在实例仍在时再次启动,PID 没变,跟着当前启动方式增加的是 onNewWant。若把两种记录都写成「重新打开」并求平均,很容易拿没有创建新窗口的样本去代表冷启动。

要留意工具本身的时序。复测中曾遇到启动命令先结束,紧接着查询还没有拿到 PID。自动检查应等到进程和业务窗口可以识别,再取这一轮的证据。若第一个 PID 是空值,第二个是真数字,简单判断两次不相等会把无效读数也归成一次冷启动。换成其他 launchType 或多窗口入口时,也应该检查看到的是哪个 Ability 实例,不能只用一个 PID 代替本轮的全部身份。

| MateBook Pro API 24 的新进程记录 | 相对首条的毫秒 |
| onCreate | 0 |
| onWindowStageCreate | 74 |
| onForeground | 91 |
| loadContent OK | 277 |
| aboutToAppear | 283 |
| onDidBuild | 315 |
这一批做了两次再次启动,在同一 PID 的时间线上又出现 7206 和 9207 毫秒的两条 onNewWant;onCreate 仍只出现一次。后面的六七秒、九秒掺入了脚本等待操作和重新发启动请求的时间,别把它们写成热启动耗时。两条轨迹留到一起的价值是同一张表能看到此前已经执行过的东西,以及新请求是附加进来而非重新产生整张表。
要在同一台 API 24 模拟器复跑,直接打开文首工程并安装 entry。打开一次后,用 hdc shell pidof com.aasd23.p6launchtrail 记下旧进程。用 aa force-stop 停止指定包,确认旧进程退出,再以 aa start -a EntryAbility -b com.aasd23.p6launchtrail 启动。等业务窗口加载,新 PID 和 UIAbility.onCreate 应同时能查到。
第二轮保留进程,使用同样的 aa start。这次把页面的末条记录与 HiLog 的 PID 对上,核对 onNewWant。最后再跑一遍,检查两次都只增加一次唤起记录。若设备同时连着几台,给各条命令指定同一个模拟器目标。读历史日志时按这次的真实 PID 过滤,因为同一标签下会混有之前运行留下的记录。
LaunchTrace.ets 把回调放到同一个时钟上
下面这一份小文件用在两个地方:Ability 里的回调以及页面侧的构建。读取当前的启动计时值,减去这一轮记录的原点,给每项附上顺序。先写 HiLog,然后把可展示的数组放入 AppStorage。页面拿到它的是一份快照,适合做筛选;真正定位时仍应该能在日志里按进程找原始记录。
import { systemDateTime } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
export interface LaunchMark {
ordinal: number;
name: string;
group: string;
millis: number;
}
const stateKey: string = 'launchTrailMarks';
let start: number = -1;
const records: LaunchMark[] = [];
export function stamp(name: string, group: string, deferUpdate: boolean = false): void {
const time = systemDateTime.getUptime(systemDateTime.TimeType.STARTUP);
if (start < 0) start = time;
const mark: LaunchMark = { ordinal: records.length + 1, name, group, millis: time - start };
records.push(mark);
hilog.info(0x0031, 'LaunchTrail', '%{public}d %{public}s +%{public}d ms',
mark.ordinal, mark.name, mark.millis);
if (deferUpdate) {
setTimeout(() => { AppStorage.setOrCreate<LaunchMark[]>(stateKey, records.slice()); }, 0);
} else {
AppStorage.setOrCreate<LaunchMark[]>(stateKey, records.slice());
}
}
代码里的 start 初始为 −1,收到第一次 stamp 才设起点。此后用相同单调时钟相减。mark 先进入 records 并以 LaunchTrail 标签记到 HiLog,再通过 records.slice() 发布快照。页面边界使用 deferUpdate 时,AppStorage 更新可以排到下一次任务,mark 的时间仍取自刚才进入 stamp 的那一刻。若把时间获取也放进 setTimeout,时间线就会记录任务终于执行的时点,原来回调何时到达反而看不到。这个次序解释了为何先记时,再发布给页面。
计时起点是应用这份记录自己的起点,第一条显示零完全正常。它没测从手指离开图标到进程创建的时间。也不能看到 onDidBuild 就写「系统这一帧已到屏幕」。若话题真的是用户等了多久才看到首帧,需要另外采系统启动或帧事件,从用户输入和系统呈现取两个时间点。日志复制、打印和页面刷新本身也会消耗一些时间,所以别为了测量在每个细小节点都加重型日志。

顺序号还有一个实用用途。两个事件恰好落在同一毫秒,在图上时间相等并不表示顺序可以任意颠倒。渲染列表还能按原来的到达次序展示,复测读日志也保留这一顺序。如果后来给埋点增加后台线程,必须给每条记录附上它所在线程或上下文,不能把多个线程的一次并发简单排成先后依赖。这个样例使用同一条应用时钟,想对齐系统中的其他事件要按实际 trace 的时间源做匹配。
EntryAbility.ets 有两个参数入口
onCreate 接的是新实例创建时的 Want。主窗口就绪以后,onWindowStageCreate 调 loadContent,回调里明确记录装载成功还是错误。另一个入口是已有实例收到启动请求时的 onNewWant。比如业务有两条通知链接,第一次通知到首页前先选对应详情,第二次通知应当能把现有窗口切到新详情。这时单把解析写在 onCreate,就可能是应用已经正确收到新请求,但画面一直显示旧内容。
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { stamp } from '../common/LaunchTrace';
export default class EntryAbility extends UIAbility {
onCreate(_want: Want, _param: AbilityConstant.LaunchParam): void {
stamp('onCreate', 'Ability');
}
onNewWant(_want: Want, _param: AbilityConstant.LaunchParam): void {
stamp('onNewWant', 'Ability');
}
onWindowStageCreate(stage: window.WindowStage): void {
stamp('onWindowStageCreate', 'Window');
stage.loadContent('pages/Index', (error) => {
stamp(error.code ? 'loadContent error' : 'loadContent OK', 'Window');
});
}
onForeground(): void {
stamp('onForeground', 'Ability');
}
onBackground(): void {
stamp('onBackground', 'Ability');
}
}
如果专门要定位窗口建立后的工作,可以把 74 到 277 毫秒先当作一段待查区域。它包含从收到窗口回调到 loadContent 的完成通知期间发生的事情,期间 91 毫秒还收到了前景回调。不能把这个区间当作某个函数独占线程。应该下钻到 loadContent 入口与异步回调之间,对照日志、线程和资源准备动作。把固定启动页临时换成一个没有资源负担的小页再采一轮,还能缩小是窗口装载的基础成本,还是业务页初始化。这个变体需要另跑,当前数字来自完整样例。
这张表里 onForeground 在装载完成日志之前。源码用 loadContent 的结果回调写「loadContent OK」,前景事件则由另一条回调单独记录。看到 91 毫秒便先读到前景是合理的,不能因此略过后面的装载结果检查。如果用户看到窗口但页面为空,优先找成功或错误那条日志。
先做一个低成本的拆法。两处都拿到 Want,但处理动作可以放到同一小块业务路由里;每次记下入口、关键目标和页面是否消费。如果一张性能图里 onNewWant 很快出现,最终页面却晚到,先查参数什么时候交给现有页面,而不是去压缩连这轮都没有执行的创建回调。若只有窗口入口有记录,后续页面一直没有出现,再查 loadContent 的路径与结果。

还有一种对照容易被忽略:窗口回调已经到了,内容装载成功以前是否安排了同步初始化。一个已经创建的窗口和一页可以操作的列表之间,可能还有处理本地配置、建立数据模型或拉取首屏数据。调试时可以先用本地空数据复现,确认装载回调和页面入口都在;再把实际路径加回来,单独测每一项。这个做法也能解释为什么偶尔看到一个白窗,而进程和前景回调都正常。
Index.ets 里的两个页面标记
页面在 aboutToAppear 留一个标记,然后在 onDidBuild 留一个。这个顺序能提示工作大概落在进入组件到构建的哪一侧;它的作用是给后续系统采集缩小范围。筛选按钮只改变显示哪些记录,不清掉 Ability 的历史。按「只看页面」时只有这两行,再切回完整,就能验证上游窗口事件仍在。误把显示筛选当作生命周期变化,会让一张截图得出相反的故事。
import { LaunchMark, stamp } from '../common/LaunchTrace';
@Entry
@Component
struct Index {
@StorageProp('launchTrailMarks') private marks: LaunchMark[] = [];
@State private pagesOnly: boolean = false;
aboutToAppear(): void {
stamp('aboutToAppear', 'ArkUI', true);
}
onDidBuild(): void {
stamp('onDidBuild', 'ArkUI', true);
}
@Builder
private TrackRow(mark: LaunchMark) {
Row({ space: 12 }) {
Text(mark.ordinal.toString().padStart(2, '0')).fontSize(12).fontFamily('monospace')
.fontColor('#334561').width(29)
Circle().width(9).height(9).fill(mark.group === 'ArkUI' ? '#246CDA' : '#758CAA')
Text(mark.name).fontSize(15).fontWeight(FontWeight.Medium).fontFamily('monospace')
.fontColor('#192C48').layoutWeight(1).maxLines(1).textOverflow({ overflow: TextOverflow.Ellipsis })
.id('event-' + mark.ordinal)
Text('+' + mark.millis + ' ms').id('launch-ms-' + mark.ordinal)
.fontSize(14).fontFamily('monospace').fontColor('#364D6E')
}.width('100%').height(41).padding({ left: 10, right: 10 })
Divider().color('#DDE5F0')
}
build() {
Scroll() {
Column({ space: 15 }) {
Row() {
Text('启动航迹').fontSize(32).fontWeight(FontWeight.Bold).fontColor('#182B45').layoutWeight(1)
Text('SESSION').fontFamily('monospace').fontSize(12).letterSpacing(2).fontColor('#2961A4')
}.width('100%')
Row({ space: 12 }) {
Column({ space: 4 }) {
Text('时间基准').fontSize(12).fontColor('#BFD8F6')
Text('onCreate + 0 ms').fontFamily('monospace').fontSize(18)
.fontColor('#F3F8FF').fontWeight(FontWeight.Medium)
}.alignItems(HorizontalAlign.Start).layoutWeight(1)
Text(this.marks.length + ' 条事件').id('total-marks').fontSize(14).fontColor('#F3F8FF')
}.width('100%').padding(15).borderRadius(7)
.linearGradient({ angle: 105, colors: [['#172943', 0], ['#23446C', 1]] })
Row({ space: 9 }) {
Text('回调时间线').fontSize(17).fontWeight(FontWeight.Bold).fontColor('#182B45').layoutWeight(1)
Button(this.pagesOnly ? '查看全部' : '只看页面', { type: ButtonType.Normal }).id('filter')
.height(32).fontSize(12).borderRadius(4).backgroundColor('#DFEAFA').fontColor('#234C7B')
.onClick(() => { this.pagesOnly = !this.pagesOnly; })
}.width('100%')
Column() {
ForEach(this.marks.filter((mark: LaunchMark) => !this.pagesOnly || mark.group === 'ArkUI'),
(mark: LaunchMark) => { this.TrackRow(mark); }, (mark: LaunchMark) => mark.ordinal.toString())
}.width('100%').backgroundColor('#FFFFFF').border({ width: 1, color: '#DCE5F2' }).borderRadius(6)
Text('标记来自应用回调。屏幕呈现时间需要单独采样。').fontSize(12).fontColor('#425A78')
}.alignItems(HorizontalAlign.Start).width('100%').constraintSize({ maxWidth: 800 }).padding(22)
}.height('100%').width('100%').backgroundColor('#F2F6FC').align(Alignment.Top)
}
}
用同一轮测试去验筛选按钮。点一次「只看页面」之后标题和可见记录只留下页面边界,再点「查看全部」恢复之前的 Ability 事件。这样能检查筛选的是显示,而不是把共用日志的数组删掉。接着重新唤起,用新事件把筛选前后的历史对上。若实现后来增加了「清空」按钮,它应该明确清的是可视历史还是重置计时起点,二者影响不同。在一个进程里清空后又把 origin 重置,会让下一条回到零;做对照时就必须给断开的两个时钟段分别标识。
在 DevEco 的 Stage 空工程内,把三份文件分别放进 entry/src/main/ets/common、entryability 和 pages;默认路由保留 pages/Index。调试用 hdc shell hilog -x -T LaunchTrail,设备不止一个时在 hdc 后加 -t 和当前目标编号。抓日志先筛当前 PID,再把 ordinal、名称和相对毫秒与页面对起来。若你只是把窗口切到后台再切回来,先查有没有发起新的启动请求。与 aa start 主动传入 Want 的这轮操作不同,单纯切换前后台得到的事件不能直接作为这份复测的替代。
FAQ|窗口记录出来了,为什么页面的表还空
查装载结果再查页面。先确认 pages/Index 与实际路由相符,回调没有错误,再确认页面观察的 AppStorage 键和保存处相同。如果日志已经有页面打点但表仍空,把筛选切回全量,看看问题是否落在展示层。若只有装载错误,继续加页面日志也没有用,要先修入口配置。
FAQ|两份冷启动日志的空档不一样
先把入口固定成同一个。用桌面图标进入首页和从通知进入详情,初始化的工作可能不同;同一入口也有机器负载和资源缓存变化。多跑几次,记录进程号、启动来源和设备状态。想比一段业务代码是否更快,就让两组样本都从相同回调到相同下一标记,保留整体范围的同时另查那一段的额外工作。一个安静环境下录到的最快值不能覆盖别的负载。
FAQ|为什么不能用 onForeground 比较完整启动
前景回调只是航迹中的一个节点。看到它并不说明全部页面内容已经绘制,也不能证明刚才一定创建了新进程。一旦读数需要跨 Ability 或时间线重置,应按系统级记录对齐。对业务埋点而言,可以把这个节点跟后面内容可用的记录分开,得到用户进入和用户能操作的两个时刻。
拿走这份记录以后,先查哪个区间
如果用户只说「开得慢」,可以请他复现两次相同动作,一次完全退出,一次关闭或切走窗口但保留应用,再把入口、页面和设备环境写在表头。若慢只发生在冷启动,先比较应用创建到窗口入口之间的工作。若两路都慢,查它们共同走的目标数据加载和页面更新。若慢只出现在通知重进,重点就变成参数怎样从 onNewWant 到现有路由。先把实际慢的一步锁定,比在不知道入口的情况下改全部初始化更容易回归。
排查完成后保留一条正例:用新参数重新拉起仍有窗口的应用,保证页面能切过去。另留一次真实冷启动读回,确认新进程不会因为抽出共享路由而漏掉默认首页。两次都算业务通过,才把额外的诊断日志降到项目需要的粒度。
最后可以给记录加一条内容就绪的标记,例如首页有首条可操作的列表并撤掉等待提示。它比 onDidBuild 更贴近应用的业务承诺。如果首页会先画骨架,构建回调可能很早,但可以点开列表要晚很多。这两次时间差同一个项目相当有用:启动小组关注窗口和页面第一次显示,业务组再追数据准备。如果实验里把这三段混成「开应用」,排查很难决定下一步谁接手。为复跑选一个确实会延迟的数据入口,再恢复原输入做一次对照,能验证新埋点反映的是内容而非某个回调例行执行。
总结 两次打开先分成新进程与已有实例,再把回调放进各自的时间线。能明确窗口在哪里开始,页面在哪里接手,才知道下一步应该查哪个文件。
更多推荐
所有评论(0)