HarmonyOS 应用性能优化 6.0 实战:停车记录我的页 —— 车主信息卡与负边距统计行组合技

前言

停车记录应用的"我的页"是车主个人中心:深灰渐变用户卡(🅿️ 头像块 + 车主小李 + 沪A·88888 车牌)、负边距上移的三列统计行(156 次停车 / ¥2.8k 累计费用 / 3 个常用地点)、四菜单列表与版本号。这页的统计行数字看起来是静态展示,实际依赖停车记录全量数据的聚合——次数、金额、常用地点数三个口径各自统计;同时车主信息卡通常还会挂一张车辆照片或用户头像,图片加载若不预取,进页时用户卡区域会先空白后闪现。本篇聚焦两个角度:一是停车统计的时段聚合——把"全部记录一次求和"改为按月份分桶的增量聚合,聚合结果随记录变更做增量更新,进页时直接读分桶缓存,同步还能产出"近三月趋势"这类顺手数据;二是信息卡图片预取——头像与车辆照片在列表页阶段就进入图片缓存,进页时命中缓存直接呈现,消除用户卡区域的加载闪变。代码基于 API 12,@kit 导入,自包含可编译。

一、问题背景

页面四区:深灰渐变用户卡(身份 + 车牌)、负边距悬浮统计行(上移 24,压在用户卡下缘)、四菜单(车辆信息/常用地点/停车记录/设置)、版本号。数据口径上,156 次与 ¥2.8k 必须与首页记录数、费用页合计一致——跨页对账是这个页面的隐性需求。

原始实现的性能问题:

第一,进页全量聚合。每次进入我的页,统计行都对全部停车记录做三次独立遍历(计数、求和、地点去重)。记录数千条后,进页时的主线程被聚合占用,负边距统计行出现在屏幕上时数字还在"迟到"。

第二,聚合结果不复用。首页显示"18 次本月"、费用页显示"¥286",各页各算各的,同一份事实被三个页面重复计算三次,还埋下对账不一致的隐患。

第三,图片无预取。用户卡头像与车辆菜单里的车辆照片,进页才发起加载,弱网下用户卡区域出现长时间占位空白;这些图片在首页、记录页其实已经出现过,却没被缓存复用。

我的页整体布局

上图为我的页整体布局:用户卡与悬浮统计行的组合是页面第一印象,两者的数据准时性决定了这页的质感。

二、原理分析

原理一:按月分桶的增量聚合。 停车记录天然带时间属性,把聚合组织为月份分桶:每条记录归入其月份桶,桶内维护 count 与 totalCost 两个累加值。全局统计 = 各桶之和;"本月统计" = 当前月桶。新增一条记录只更新所在桶(O(1)),删除或修改做反向增量。全量重算只在数据导入、批量清除这类罕见事件发生。分桶结构同时免费产出趋势数据——近三个月的次数与费用就是三个桶的读数,费用页的五柱图也吃同一份分桶。

原理二:聚合的单点权威。 聚合器设计为单例数据仓库,我的页、首页、费用页都从它读数。156/2.8k/3 这三个数字与首页"18 次"的月度数字、费用页"¥286"的月度金额出自同一批桶,跨页对账从"人工保证"变成"结构保证"。

原理三:图片预取链路。 图片预取的核心是"在用户到达之前让字节就位"。停车应用里车主头像与车辆照片是稳定资源(变更频率极低),在首页构建时就用图片组件的预加载能力把 URL 送进缓存;我的页进页时 Image 组件命中内存缓存,首帧即完整呈现。预取列表要克制——只预取"确定性会看"的图片(本页头像 + 车辆卡照片),把预取流量花在命中率最高的资源上。

原理四:常用地点数的维护策略。 "3 个常用地点"不是每次对记录做地点去重(O(n) 且随记录增长变慢),而是常用地点表自身的行数——地点的增删发生在常用地点管理里,统计只是读表行数。把"统计"还原为"它本来就该是的事实",是最便宜也最不容易错的优化。

三、代码实现

以下代码块属同一 .ets 文件,按顺序拼接,可整体替换原页面文件编译运行。

第一段:月度分桶聚合器(含增量更新与跨页共享)。

interface ParkingRecord {
  id: number;
  place: string;
  month: number;   // 1~12
  cost: number;
}

// 月份桶:增量聚合的最小单元
interface MonthBucket {
  month: number;
  count: number;
  totalCost: number;
}

interface OwnerStats {
  totalCount: number;
  totalCostDisplay: string;
  nearMonths: MonthBucket[];
}

class Theme {
  static readonly bg: string = '#F2F5FB';
  static readonly card: string = '#FFFFFF';
  static readonly stroke: string = '#EAEEF6';
  static readonly text: string = '#1C2333';
  static readonly textSub: string = '#5A6483';
  static readonly textDim: string = '#9AA3BC';
  static readonly dark: string = '#2D3436';
  static readonly darkAccent: string = '#636E72';
  static readonly pad: number = 16;
}

// 分桶聚合仓库:单点权威,多页共享
class ParkingStatsRepo {
  private buckets: Map<number, MonthBucket> = new Map<number, MonthBucket>();

  rebuildAll(records: ParkingRecord[]): void {
    this.buckets.clear();
    for (let i = 0; i < records.length; i++) {
      this.append(records[i]);
    }
  }

  // 增量追加:O(1)
  append(r: ParkingRecord): void {
    let b = this.buckets.get(r.month);
    if (b === undefined) {
      b = { month: r.month, count: 0, totalCost: 0 };
      this.buckets.set(r.month, b);
    }
    b.count += 1;
    b.totalCost += r.cost;
  }

  // 增量移除:反向扣减,桶空则移除
  remove(r: ParkingRecord): void {
    const b = this.buckets.get(r.month);
    if (b === undefined) {
      return;
    }
    b.count -= 1;
    b.totalCost -= r.cost;
    if (b.count <= 0) {
      this.buckets.delete(r.month);
    }
  }

  private sum(): { c: number, s: number } {
    let c = 0;
    let s = 0;
    this.buckets.forEach((b: MonthBucket) => {
      c += b.count;
      s += b.totalCost;
    });
    return { c: c, s: s };
  }

  ownerStats(): OwnerStats {
    const t = this.sum();
    const near: MonthBucket[] = [];
    for (let m = 6; m <= 8; m++) {
      const b = this.buckets.get(m);
      near.push(b === undefined ? { month: m, count: 0, totalCost: 0 } : b);
    }
    return {
      totalCount: t.c,
      totalCostDisplay: t.s >= 1000 ? (t.s / 1000).toFixed(1) + 'k' : Math.round(t.s).toString(),
      nearMonths: near
    };
  }
}

第二段:我的页组件——统计行读仓库缓存 + 用户卡图片预取呈现。

@Entry
@Component
struct ParkingMine {
  private repo: ParkingStatsRepo = new ParkingStatsRepo();
  @State private stats: OwnerStats = {
    totalCount: 0, totalCostDisplay: '0', nearMonths: []
  };
  // 稳定图片资源:低变更频率,适合预取
  private readonly avatarUrl: string =
    'https://i-blog.csdnimg.cn/direct/7b3203be698443098c0fbff965995430.png';
  private readonly carPhotoUrl: string =
    'https://i-blog.csdnimg.cn/direct/f58d876be07b482b8cabe1dbc4296855.png';

  aboutToAppear(): void {
    // 演示数据重建分桶;真实场景由数据层在记录增删时调用 append/remove
    const demo: ParkingRecord[] = [];
    const costs: number[] = [12, 15, 20, 8, 18, 25, 14, 9, 30, 16];
    for (let i = 0; i < 156; i++) {
      demo.push({ id: i + 1, place: '公司车库', month: (i % 8) + 1, cost: costs[i % costs.length] });
    }
    this.repo.rebuildAll(demo);
    this.stats = this.repo.ownerStats();
  }

  @Builder
  UserCard() {
    Row({ space: 14 }) {
      Row() {
        Image(this.avatarUrl)
          .width(56).height(56).borderRadius(28)
          .objectFit(ImageFit.Cover)
          .alt($r('sys.media.ohos_ic_public_clock'))
      }
      .width(64).height(64).backgroundColor('#33FFFFFF').borderRadius(32)
      .justifyContent(FlexAlign.Center)
      Column({ space: 5 }) {
        Text('车主小李').fontSize(18).fontWeight(FontWeight.Bold).fontColor('#FFFFFF')
        Text('沪A·88888 · 累计停车 ' + this.stats.totalCount.toString() + ' 次')
          .fontSize(12).fontColor('#FFFFFF').opacity(0.85)
      }.alignItems(HorizontalAlign.Start).layoutWeight(1)
    }
    .width('100%').padding(24)
    .linearGradient({ angle: 135, colors: [[Theme.dark, 0.0], [Theme.darkAccent, 1.0]] })
  }

  @Builder
  StatRow() {
    Row() {
      Column({ space: 4 }) {
        Text(this.stats.totalCount.toString()).fontSize(20).fontWeight(FontWeight.Bold).fontColor(Theme.dark)
        Text('停车次数').fontSize(11).fontColor(Theme.textDim)
      }.layoutWeight(1)
      Column({ space: 4 }) {
        Text('¥' + this.stats.totalCostDisplay).fontSize(20).fontWeight(FontWeight.Bold).fontColor(Theme.dark)
        Text('累计费用').fontSize(11).fontColor(Theme.textDim)
      }.layoutWeight(1)
      Column({ space: 4 }) {
        Text('3').fontSize(20).fontWeight(FontWeight.Bold).fontColor(Theme.dark)
        Text('常用地点').fontSize(11).fontColor(Theme.textDim)
      }.layoutWeight(1)
    }
    .width('92%').padding({ top: 14, bottom: 14 })
    .backgroundColor(Theme.card).borderRadius(16)
    .border({ width: 1, color: Theme.stroke })
    .margin({ top: -24 })
  }

  @Builder
  MenuList() {
    Column() {
      ForEach(['车辆信息', '常用地点', '停车记录', '设置'], (m: string) => {
        Row({ space: 12 }) {
          Text(m).fontSize(14).fontColor(Theme.text).layoutWeight(1)
          // 车辆信息菜单行内嵌车辆照片:预取缓存命中后秒开
          if (m === '车辆信息') {
            Image(this.carPhotoUrl)
              .width(44).height(32).borderRadius(6)
              .objectFit(ImageFit.Cover)
              .alt($r('sys.media.ohos_ic_public_clock'))
          }
          Text('>').fontSize(14).fontColor(Theme.textDim)
        }
        .width('100%').padding({ top: 14, bottom: 14 })
        .onClick(() => {
          this.getUIContext().getPromptAction().showToast({ message: m });
        })
        if (m !== '设置') {
          Divider().strokeWidth(0.5).color(Theme.stroke)
        }
      }, (m: string) => m)
    }
    .width('100%').padding({ left: 16, right: 16 })
    .backgroundColor(Theme.card).borderRadius(16)
    .border({ width: 1, color: Theme.stroke })
  }

  build() {
    Column() {
      Scroll() {
        Column() {
          this.UserCard()
          this.StatRow()
          Column({ space: 14 }) {
            this.MenuList()
            Text('停车缴费记录 Version 1.0.0').fontSize(11).fontColor(Theme.textDim)
              .margin({ top: 10 })
          }
          .width('100%')
          .padding({ left: Theme.pad, right: Theme.pad, bottom: 40 })
        }
        .width('100%')
      }
      .layoutWeight(1).scrollBar(BarState.Off).align(Alignment.Top)
    }
    .width('100%').height('100%').backgroundColor(Theme.bg)
  }
}

点击设置菜单

菜单点击保持 Toast 反馈,如上图。图片预取链路在真实工程中由首页阶段的预加载调用完成,本页只负责"命中即呈现"。

点击车辆信息菜单如上图,行内车辆照片走预取缓存呈现。

点击车辆信息菜单

四、性能对比与验证方法

测量条件如下表:

项目条件
设备档位中端真机(8GB RAM)+ 低端真机(4GB RAM),弱网与 Wi-Fi 两档网络
系统/SDK 版本HarmonyOS NEXT API 12,DevEco Studio 5.0
数据规模156 / 2000 / 10000 条停车记录三组
采样次数进页 10 次取中位数;记录增删 100 次增量与全量对照
打点方式aboutToAppear 聚合打点;图片首帧用 Image 组件 onComplete 时间戳

以下为示例实测值,非设备基准数据,需在目标机型复测:

指标(10000 条记录)优化前优化后变化幅度
进页聚合耗时8.7ms(三次全量遍历)0.2ms(读分桶)-98%
新增一条记录的统计更新O(n) 全量重算O(1) 桶内累加量级下降
头像图片首帧呈现(弱网)420ms 后闪现命中缓存 0ms消除闪变
跨页数字对账人工同步结构同源消除风险

验证方法:聚合耗时在 ownerStats 调用前后打点;增量正确性用"随机 100 次增删后,增量结果与 rebuildAll 全量结果逐字段比对"的测试断言;图片首帧在弱网模拟下用 onComplete 打点对比。反直觉结论:分桶聚合在记录总量小(156 条)时反而比三次直遍历慢约 0.1ms——Map 结构与桶对象的固定开销在小数据下不划算;分桶的价值拐点在千条级与"高频增量"场景,统计页每次全量重算 10ms 以上时才值得引入。

点击停车记录菜单如上图,统计行读数来自分桶聚合仓库。

点击停车记录菜单

五、优化建议与工程化落地

第一,ParkingStatsRepo 挂到应用级单例。首页、费用页、我的页三处读数全部走它,配合记录仓库的增删回调自动维护桶,杜绝任何页面自己 sum。

第二,分桶粒度可配置。月桶适合停车场景,若产品要看周趋势,把桶键从月份换成 ISO 周号即可,聚合器骨架不变。

第三,图片预取清单集中管理。头像、车辆照片、常用地点封面组成"我的页预取集",由首页 aboutToAppear 统一预热;预取集与页面实际用图的一致性写成常量表避免漂移。

第四,金额显示格式统一。¥2.8k 的千位缩写规则(k 保留一位小数)放在聚合器的 display 层,首页、费用页引用同一格式化函数,避免"2860"与"2.8k"混排。

第五,负边距悬浮层的合成稳定性。统计行悬浮在渐变卡上,用户卡保持静态无动画(与续费提醒篇同一纪律),保证悬浮层一次合成全程复用。

本篇配图。

六、总结:HarmonyOS 应用性能优化的口径与就位

这页的两个优化共享同一个思想:让数据在正确的时间就位。统计口径在数据层一次算好、随记录变更增量维护,进页时读数即得——口径的单点权威顺带解决了跨页对账;图片在用户到达前进入缓存,进页时命中即呈现——预取把网络延迟挪出了关键路径。车主个人中心的信息密度不高,但对"数字准不准、图快不快"极其敏感:数字是信任,图片是质感。把聚合变成增量、把加载变成预取,这页就在千元机上也保持了"进页即完整"的体感。

Logo

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

更多推荐