yayacal/DEVELOPMENT.md
xfy 4eadc479eb feat: 添加 testTag 基础设施,扩展 Baseline Profile 覆盖路径
为 CalendarPager、BottomCard、FAB、工具页、日期检查器等关键 UI 元素添加 testTag,
启用 testTagsAsResourceId 支持 UI Automator 通过 resource-id 定位。
BaselineProfileGenerator 使用 testTag 选择器重写,覆盖工具页、日期检查器、
DatePicker 等更多导航路径。清理 DEVELOPMENT.md 移除已过时的性能瓶颈描述。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 10:03:16 +08:00

2.1 KiB
Raw Blame History

开发指南

性能追踪

使用 scripts/profile.sh 一键抓取 Perfetto trace、帧统计和内存快照。

# 默认抓取 8 秒
./scripts/profile.sh

# 抓取 15 秒
./scripts/profile.sh 15

# 应用已在运行时,不自动启动
./scripts/profile.sh --no-launch

输出文件保存在 logs/ 目录:

文件 说明
trace_*.perfetto-trace Perfetto tracehttps://ui.perfetto.dev 打开
framestats_*.txt GPU 帧统计
meminfo_*.txt 内存快照
report_*.md 追踪报告摘要

trace 中包含自定义标记:

  • MonthView:Compose — 月视图重组
  • YearView:Compose — 年视图重组
  • YearGridView:* — 年视图网格组合(首帧耗时关键指标)
  • generateMiniMonthDays:* — 月份网格计算
  • VM:collapseProgress — 折叠动画

Baseline Profile

# 编译 Android debug APK
./gradlew :app:assembleDebug

# 安装到设备
./gradlew :app:installDebug

# 编译 release APK含 Baseline Profiles
./gradlew :app:assembleRelease

./gradlew :app:installBenchmark

Baseline Profile 自动生成器。

运行方式(一键生成 + 自动复制到 :core

./gradlew :macrobenchmark:updateBaselineProfile

仅运行基准测试(不自动复制):

./gradlew :macrobenchmark:connectedBenchmarkAndroidTest

手动复制路径: macrobenchmark/build/outputs/connected_android_test_additional_output/

测试覆盖全部用户交互路径,实现全量 AOT

  1. 冷启动 → 首帧渲染
  2. FAB 展开 → 年视图 → 月视图
  3. 日期选择 → 周视图折叠/展开
  4. 关于页 → 开源许可页
  5. 返回主界面

模拟器

emulator -avd Pixel_10 \
  -no-snapshot \
  -no-boot-anim \
  -gpu host \
  -accel on \
  -cores 4 \
  -memory 4096 \
  -partition-size 2048