HarmonyOS 6 路线详情:Navigation 跳转前先准备站点,等到数据少了多久
配套工程源码、测试材料与运行说明
前言
点开路线以后,我关心四个站名什么时候出现在详情里。这里用 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 毫秒的路径相像。如果准备中途更换选择,等了一半又弃用的任务也单独算。这样不仅有一次点击后的时间,还有判断选择策略是否合适的依据。
总结
等的是站名,所以把站名的读取提前,页面依旧按原来的路由打开。给每次点击带上线路身份,在途的任务可以共享,旧页面也应知道什么时候停止回填。这样换数据源以后依然有可定位的边界。
更多推荐
所有评论(0)