配套工程源码、测试材料与运行说明

前言 我把三次启动留在同一张时间线上。第一轮的 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 更贴近应用的业务承诺。如果首页会先画骨架,构建回调可能很早,但可以点开列表要晚很多。这两次时间差同一个项目相当有用:启动小组关注窗口和页面第一次显示,业务组再追数据准备。如果实验里把这三段混成「开应用」,排查很难决定下一步谁接手。为复跑选一个确实会延迟的数据入口,再恢复原输入做一次对照,能验证新埋点反映的是内容而非某个回调例行执行。

总结 两次打开先分成新进程与已有实例,再把回调放进各自的时间线。能明确窗口在哪里开始,页面在哪里接手,才知道下一步应该查哪个文件。

华为开发者文档:应用启动流程

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐