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

前言

点开路线以后,我关心四个站名什么时候出现在详情里。这里用 Navigation 管路由,NavPathStack.pushPath 带线路参数进入详情。站点等待来自应用里的 1,300 ms 模拟数据源,提前准备也是业务仓库主动发起的操作。用相同的等待设置跑两个入口,可以量出点击后还要等站名多久。预取前段已经花过的时间要单记,本例没有测系统导航动画或鸿蒙系统路由预加载接口。

准备完成与点击跳转,是两个时间点

MateBook Pro 模拟器 API 24

点击到站名就绪

显示结果

直接开桥下线

1,319 ms

四站

先准备夜航线再打开

29 ms

四站

两边走同一个 Navigation 详情,数据源都设置 1300 毫秒的等待。第一条在点击后才开始等;第二条点击以前已经结束等待。选两条不同线路,是为了第一轮装入的缓存不带进第二轮的准备过程。这个差距说明演示把站点准备换了时机。它不能说明线上真实网络就要花 1300 毫秒,也没有测系统呈现第一帧。

这次手工观察的标签也能帮助复现。直接开桥下线,详情提示「进入后等待数据」;返回首页切成夜航线时首页是「未准备」。点准备并等它变为「站点数据已就绪」,再进入详情,标签变成「已命中准备好的数据」。读数是从按打开按钮到回填站点,没有把准备按钮的等待折到 29 毫秒里。若目标是用户点进详情少等,这是有用的数字;若目标是统计总工作或电量,还得从准备动作开始另记。两份页面最终都显示自己的线路并有四站,所以台面上比较的是得到同类结果的两种时机。

Trip 记住点的是哪条线

this.stack.pushPath({
  name: 'route',
  param: new Trip(this.selected, tick())
});

跟着点击处理可以看到 Navigation 的名称相同,差异是传进参数的 line 和 tick。详情构建时应该读自己的 NavPathStack 路由参数,把同一份仓库交过来。如果每一个详情各 new 一个仓库,并没有从父页注入共享实例,首页提前准备好的线路就无法命中。这种错接常见于拆分文件之后,视觉上两页都正常,首页也显示已就绪,详情却又走回源。定位时可以在开发阶段给日志留同一个线路键和同一个仓库身份,确认两处操作真的在读同一份缓存。

路由参数是一次点击的快照,里边记线路号和当时的计时值。详情用它打开自己的线路,拿到站名时再用同一个基准算经过了多久。若等详情的 aboutToAppear 才重新记起点,那么之前导航路过的时间不会被记下来,两张表即使用同样的「点击到结果」标题,也已经在比较别的东西。如果改成到详情里读首页当前的选择,还可能在用户切换时拿错路线。

哪个实例保存站点,谁能等同一份结果

class RouteRepo {
  private ready: Map<number, RouteData> = new Map();
  private pending: Map<number, Promise<RouteData>> = new Map();
  reads: number = 0;

  has(line: number): boolean { return this.ready.has(line); }

  load(line: number): Promise<RouteData> {
    const cached = this.ready.get(line);
    if (cached) return Promise.resolve(cached);
    const shared = this.pending.get(line);
    if (shared) return shared;
    this.reads++;
    // 固定延时代表示例数据源等待,不是网络实测。
    const work = new Promise<RouteData>((resolve: (data: RouteData) => void) => {
      setTimeout(() => {
        const result = new RouteData(line);
        this.ready.set(line, result);
        this.pending.delete(line);
        resolve(result);
      }, DELAY);
    });
    this.pending.set(line, work);
    return work;
  }
}

RouteRepo 两张表是给两个不同问题用的。ready 回答「已经有可用站名吗」,pending 回答「同一路线已经有人在取了吗」。先查已完成,找不到才问在途。如果也没有,再增加读取计数、建一次工作。读取结束把结果放到 ready,移走 pending,等同一个 Promise 的几个使用者都能拿到一样的 RouteData。如果只存完成结果,首页刚开始准备,用户立刻点详情,双方都可能觉得手里还没有数据,接着各自请求一次。

详情会在调用 load 前从 has(trip.line) 读取 warm,画面上的命中标记因此表示「进入详情那一刻是否已有可用内容」。假如在首页按完准备就立即打开,可能会共享 pending,但当时 warm 仍是 false,详情会正确显示「进入后等待数据」。可以看状态在准备前和等待中的区别。这个中途进入用例用于补充验证共享请求,实测表的第二行等到了「站点数据已就绪」,并不属于这个用例。

回源计数和缓存命中是另一个好观察点。第一次准备路线会增加计数;已经有结果的路线再次去请求,不必重新取;准备中马上点详情,仍可与首页共享一个等待。最后这条值得作为真实服务的回归:界面没有「已准备」时提前打开,应该仍能在现有 Promise 完成时显示结果。别因为它没有第二次访问服务器就误写成用户完全不等待,等待中的复用能省工作,却不会让未返回的数据提前出现。

真实线路还可能先返回一个最新版本号、随后才取得站点数组。共享的 Promise 应该代表调用者真正能使用的结果。若首页只看到一个版本号就显示准备好,详情仍得等站名,用户感觉并没有变。实验可以约定四站都拿到才打完成,再把「站点准备中」与「线路元信息已知」做成两个状态。若需要只显示起点和终点,也应该把这组可读资料的范围写清楚。同一个项目保持相同口径,比较起来才不会把条件宽松了误作加速。

提示必须跟着当前选择

const version = ++this.version;
this.state = '正在准备站点';
this.repo.load(this.selected).then((): void => {
  if (version === this.version) this.state = '站点数据已就绪';
});

首页 warmup 记录本次 version,准备结束时比较版本才显示「站点数据已就绪」。详情自己用 active,在离开后让过时的异步返回不再更新界面。一次返回仍可让仓库保存有用资料,回写控制理的是当前 UI 的归属。快速点两次不同线路,可以观察慢到的旧线路是否会改掉新线路的提示。两个版本字段看起来像重复,实际上一个用来保护首页选中状态,一个保护详情生命周期。

aboutToAppear(): void {
  this.warm = this.repo.has(this.trip.line);
  this.repo.load(this.trip.line).then((route: RouteData): void => {
    if (!this.active) return;
    this.stops = route.stops;
    this.elapsed = tick() - this.trip.clicked;
  });
}

aboutToDisappear(): void { this.active = false; }

真的接网络时,还要处理请求失败。示例的固定数据源会成功,产品的 pending 也应在失败路径清掉,否则下次一直得到一份已经拒绝的 Promise。回退时保留上一份可用站点还是让用户重试,需要看线路资料的时效。若临时变更站序,不能只按线路编号缓存一个永久结果。可以加方向和班次日期,必要时加入有效期或更新标志。时间应当由业务规则解释,不能照搬演示延迟。

如果取消准备,先问还有没有别的使用者。首页换到另一条线时已经有人在详情等待同一个任务,首页取消自己的展示不等于要立刻中断请求。反过来,内容过期或账户切换可能要求整条结果都不再生效。可以把请求层归属、缓存键和 UI 写回的保护分开。代码中 active 并不去取消超时,因为这个仓库还可保留成功的站点数据。这个选择和演示共享资料有关,接到机密或很快变动的数据要另外规定。

先打开桥下线,再用「提前准备站点」

用文首工程在 API 24 的 entry 运行。先直接打开桥下线,从旧码头到城西口,记录点击到数据就绪;回首页选夜航线,点「提前准备站点」,等首页标出就绪,再打开详情,从剧院到灯塔。两边分别有四行,验收还要对照首尾站。读到 1,319 ms 和 29 ms 时,先核对前者从点击开始等待模拟响应,后者已经命中应用缓存。对接真实服务后要另记预取耗时、命中率和失败再取,才能决定是否值得提前加载。

import { systemDateTime } from '@kit.BasicServicesKit';

const LINES: string[] = ['桥下线', '夜航线'];
const PLACES: string[][] = [['旧码头', '铁桥', '露台公园', '城西口'], ['剧院', '海关钟楼', '北岸', '灯塔']];
const DELAY: number = 1300;

function tick(): number {
  return systemDateTime.getUptime(systemDateTime.TimeType.STARTUP);
}

class RouteData {
  line: number;
  stops: string[];
  constructor(line: number) {
    this.line = line;
    this.stops = PLACES[line].slice();
  }
}

class Trip {
  line: number;
  clicked: number;
  constructor(line: number, clicked: number) {
    this.line = line;
    this.clicked = clicked;
  }
}

class RouteRepo {
  private ready: Map<number, RouteData> = new Map();
  private pending: Map<number, Promise<RouteData>> = new Map();
  reads: number = 0;

  has(line: number): boolean { return this.ready.has(line); }

  load(line: number): Promise<RouteData> {
    const cached = this.ready.get(line);
    if (cached) return Promise.resolve(cached);
    const shared = this.pending.get(line);
    if (shared) return shared;
    this.reads++;
    // 固定延时代表示例数据源等待,不是网络实测。
    const work = new Promise<RouteData>((resolve: (data: RouteData) => void) => {
      setTimeout(() => {
        const result = new RouteData(line);
        this.ready.set(line, result);
        this.pending.delete(line);
        resolve(result);
      }, DELAY);
    });
    this.pending.set(line, work);
    return work;
  }
}

@Component
struct Detail {
  private repo: RouteRepo = new RouteRepo();
  private trip: Trip = new Trip(0, 0);
  private back: () => void = (): void => {};
  @State stops: string[] = [];
  @State elapsed: number = -1;
  @State warm: boolean = false;
  private active: boolean = true;

  aboutToAppear(): void {
    this.warm = this.repo.has(this.trip.line);
    this.repo.load(this.trip.line).then((route: RouteData): void => {
      if (!this.active) return;
      this.stops = route.stops;
      this.elapsed = tick() - this.trip.clicked;
    });
  }

  aboutToDisappear(): void { this.active = false; }

  build() {
    NavDestination() {
      Column({ space: 16 }) {
        Row() {
          Button('返回线路').id('tram-back').onClick(() => this.back())
            .backgroundColor('#202324').fontColor('#F8D85C')
          Blank()
          Text(this.warm ? '已命中准备好的数据' : '进入后等待数据')
            .id('tram-detail-mode').fontSize(16).fontColor('#3E413F')
        }.width('100%')
        Text(LINES[this.trip.line]).id('tram-detail-title').fontSize(51)
          .fontWeight(FontWeight.Bold).fontColor('#232825').width('100%')
        Text(this.elapsed < 0 ? '等候站点数据…' : '点击至数据就绪 ' + this.elapsed + ' ms')
          .id('tram-time').fontSize(20).fontColor('#28453B').width('100%')
        Row({ space: 0 }) {
          ForEach(this.stops, (stop: string, index: number) => {
            Column({ space: 13 }) {
              Text('0' + (index + 1)).fontSize(15).fontWeight(FontWeight.Bold).fontColor('#213128')
              Line().width('100%').height(4).startPoint([0, 2]).endPoint(['100%', 2])
                .stroke('#1F5345').strokeWidth(4)
              Text(stop).fontSize(20).fontWeight(FontWeight.Medium).fontColor('#24362E')
            }.layoutWeight(1).padding({ top: 16, bottom: 16 }).backgroundColor('#F6F4DB')
          }, (stop: string): string => stop)
        }.width('100%')
      }.width('100%').height('100%').alignItems(HorizontalAlign.Start)
        .padding({ left: '8%', right: '8%', top: 28 }).backgroundColor('#F6D755')
    }.hideTitleBar(true)
  }
}

@Entry
@Component
struct Index {
  private stack: NavPathStack = new NavPathStack();
  private repo: RouteRepo = new RouteRepo();
  @State selected: number = 0;
  @State state: string = '未准备';
  private version: number = 0;

  private select(line: number): void {
    this.version++;
    this.selected = line;
    this.state = this.repo.has(line) ? '站点数据已就绪' : '未准备';
  }

  private warmup(): void {
    const version = ++this.version;
    this.state = '正在准备站点';
    this.repo.load(this.selected).then((): void => {
      if (version === this.version) this.state = '站点数据已就绪';
    });
  }

  @Builder
  Destination(name: string, param: object) {
    if (name === 'route') {
      Detail({ trip: param as Trip, repo: this.repo, back: (): void => {
        this.stack.pop();
        this.state = this.repo.has(this.selected) ? '站点数据已就绪' : '未准备';
      } })
    }
  }

  build() {
    Navigation(this.stack) {
      Column({ space: 22 }) {
        Text('末班路线').fontSize(56).fontWeight(FontWeight.Bold).fontColor('#F8D85C')
          .width('100%')
        Text('TRAM / 城市电车站点手册').fontSize(17).fontColor('#F1E8C6').width('100%')
        Row({ space: 16 }) {
          ForEach(LINES, (line: string, index: number) => {
            Button('0' + (index + 1) + '  ' + line).id('tram-line-' + index)
              .height(72).fontSize(23).layoutWeight(1).onClick(() => this.select(index))
              .backgroundColor(this.selected === index ? '#F8D85C' : '#39423C')
              .fontColor(this.selected === index ? '#1F2521' : '#F6F0D9')
          }, (line: string): string => line)
        }.width('100%')
        Text(this.state).id('tram-home-state').fontSize(19).fontColor('#F1E8C6').width('100%')
        Row({ space: 14 }) {
          Button('提前准备站点').id('tram-warm').backgroundColor('#39423C').fontColor('#FFFFFF')
            .onClick(() => this.warmup())
          Button('打开线路详情').id('tram-open').backgroundColor('#F8D85C').fontColor('#25281E')
            .onClick(() => { this.stack.pushPath({ name: 'route', param: new Trip(this.selected, tick()) }); })
        }.width('100%')
      }.padding({ left: '8%', right: '8%', top: 35 }).width('100%').height('100%')
        .backgroundColor('#252D28')
    }.width('100%').height('100%').hideTitleBar(true).mode(NavigationMode.Stack)
      .navDestination(this.Destination)
  }
}

本次是 MateBook Pro API 24 模拟器,运行版本 6.1.0.125(SP12DEVC00E47R1P3)。在 ArkTS Stage 工程把代码放入 entry/src/main/ets/pages/Index.ets,保留默认路由。从首页按「打开线路详情」,直到用时出现,再按「返回线路」。切到夜航线后按「提前准备站点」,待状态更新再打开。保留同一个应用进程做正向对照;若复跑需要重新测未准备,重启后再看初始状态,因为同一个仓库可能已保存上次读到的站名。

测试还可以设计成手动注入慢资源。一条线路等待超过预期时,尝试快速回去打开另一条。标题、站点数组和耗时要对应当前这次点击,不能跑出上一条线的旧值。若两条所用地区、日期、方向不同,资源键也相应区分。这类功能验收尽量单独留,与性能表中的单人顺序点击区别开来。性能表只有两行不代表两个按钮的全部可能路径;它先说明准备时机,值不应被解释为真实业务额度。

开始做缓存之前也可以看操作频率。首页只有两个常见入口,准备最可能打开的一条合理;二十条线路全部准备可能拖慢首页,给还没点击的人带来访问。最好先用实际的点击以及准备命中记录找收益。若产品里用户经常选完就返回,可以在选项停留一小会儿后再准备,或逐条观察。继续跑的话应同时留一次「没有预加载也能正常点开」的正例。

后续采样时可以留三行:冷线路直接打开、进行中即打开、已准备以后打开。把每行的调用次数、从点击到可读的时间、最终站点列表一起记下来。有准备中的一行,就能看出来收益到底来自去重还是来自已经就绪。若两次打开不同线路均有四站而文本对不上,先检查 Trip 里是不是正确的编号。性能测试有时只断言条目数量,正好漏掉资料串线。

再选一个真实离开动作做负例:详情进来以后立即返回,随后打开另一路线,最后让前一个请求结束。前一个结果可以留在属于它的仓库,但页面应仍显示后一个路线。将这一项与点击后的时间分别验,提前准备才不会靠牺牲内容一致性来变好看。

FAQ|再次进入为什么看起来更快

先查仓库是否命中,再检查是否仍新建了详情。应用可以继续创建一个普通页面,同时直接读已有站名。这个场景的快因来自已有资料。要复用滚动位置、展开卡片或者整个实例,还需给页面的重建和状态恢复单独留观察点。

首页与详情使用同一个 NavPathStack。进入时 pushPath,详情的返回回调 pop。单独读这两处可以查是否因为按了返回重新启动了应用。若只是出栈,父页持有的 RouteRepo 仍在;真正销毁整个父页后再进入,则应重新建立对照的冷状态。

FAQ|准备时间会不会挤到用户正在操作的那段

会有这种可能。下载和解析都有开销,特别是站点还带大图时,可以先准备小而稳定的数据,图片留给详情按需。复跑首页滚动、切换和返回,记下准备有没有影响这些动作。完成量相同不代表调度位置无关紧要。

下次决定要不要留预准备,可以另外记录「准备了但没进详情」和「进详情前已经就绪」的次数。前者花了成本而没有立即得到好处,后者才和这张 29 毫秒的路径相像。如果准备中途更换选择,等了一半又弃用的任务也单独算。这样不仅有一次点击后的时间,还有判断选择策略是否合适的依据。

总结

等的是站名,所以把站名的读取提前,页面依旧按原来的路由打开。给每次点击带上线路身份,在途的任务可以共享,旧页面也应知道什么时候停止回填。这样换数据源以后依然有可定位的边界。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐