xfy 564e4e3960 refactor: 清理无效 ProGuard 规则、调试日志，trace 解耦 VM

P0 正确性与工程卫生修复：

- 删除 core/proguard-rules.pro 中全部无效的 -keepclassmembers 规则
  (LunarCache.getOrCompute 实为实例 suspend 方法，generateMonthDays 实为
   private，签名均不匹配，属 placebo)；同时移除 core/build.gradle.kts
  release block 内重复的 consumerProguardFiles 声明
- 将 7 处 composeTrace 调用从 CalendarViewModel 移至 Compose 层
  (MenuItem.onClick / onMonthClick / BottomCard 回调)，VM 不再依赖
  android.os.Trace，可在纯 JVM 环境测试无需兜底
- 删除 CalendarViewModel 与 4 个 UI 文件中约 30 处 logd 调用及其辅助
  变量/ SideEffect/ DisposableEffect (AnimLog.kt 工具函数保留)
- 删除 CalendarViewModel.getIsoWeekNumber 不可达的 weekNumber < 1 递归分支
- 修正 MainActivity.kt setContent 块缩进错位
- 同步 README: sketch 渲染 GIF→动画 WebP，补提 :macrobenchmark 模块；
  删除 AGENTS.md 顶部过时的「README 与实际不符」注释

验证: spotlessApply UP-TO-DATE, testDebugUnitTest 全过,
       assembleDebug + assembleRelease (R8) 均成功

2026-06-15 16:24:38 +08:00

3.6 KiB

Raw Blame History

YaYa

纯 Android + Jetpack Compose 日历应用。功能：农历/节气/节日、个人班次排期（WORK/OFF 循环）、月/周/年三视图。

模块结构

模块	类型	职责
`:core`	`com.android.library`	所有 Compose UI、ViewModel、业务逻辑
`:app`	`com.android.application`	薄壳：MainActivity + Manifest + 主题
`:macrobenchmark`	`com.android.test`	Baseline Profile 生成

铁律：:app 不添加业务逻辑，所有代码写在 :core。

常用命令

./gradlew :app:assembleDebug                          # 构建 debug APK
./gradlew :app:installDebug                           # 安装到设备
./gradlew :core:testDebugUnitTest                     # 运行全部单元测试
./gradlew :core:testDebugUnitTest --tests "plus.rua.project.ui.CalendarUtilsTest"  # 单类
./gradlew spotlessApply                               # 格式化（ktlint）

Baseline Profile 和性能追踪需连接设备：

./gradlew :macrobenchmark:updateBaselineProfile       # 生成 + 自动复制到 core/src/main/baseline-prof.txt
./scripts/profile.sh                                  # 默认 8 秒，输出到 logs/

构建配置

AGP 9.2.1 · Kotlin 2.3.21 · JVM target 17
compileSdk/targetSdk 37 · minSdk 24
版本目录：gradle/libs.versions.toml
构建类型：debug（默认）、release（R8 混淆 + 资源压缩）、trace（release + trace 标记保留）、benchmark（macrobenchmark 专用）
R8：android.enableR8.fullMode=true（gradle.properties）
缓存：configuration cache + build cache 已启用
版本号：动态 baseVersion_gitHash_buildDate（例：1.0.0_a1b2c_010626）
格式化：Spotless + ktlint，覆盖 src/**/*.kt 和 *.gradle.kts（根 build.gradle.kts）

包名

:core 逻辑层：plus.rua.project
:core UI 层：plus.rua.project.ui
:core android.namespace 实际为 plus.rua.project.shared（build.gradle.kts），但代码包名用 plus.rua.project
:app：plus.rua.project

代码规范

公共 @Composable 函数必须有 KDoc（参数说明 + 回调触发时机），见 COMMENTS.md
Modifier 参数始终放签名最后
回调参数用 on 前缀（onDateClick）
可点击列表项用 Card(onClick = ...) + CardDefaults.cardElevation(defaultElevation = 0.dp)，不要用 Modifier.clickable() 裸包
@Suppress("DEPRECATION") 必须附带行内注释说明原因（当前主要用于 monthNumber）
UI 文本使用中文
禁止 java.util.Calendar，日期逻辑全部用 kotlinx-datetime

关键依赖

Compose BOM 2026.05.01 + Material 3
kotlinx-datetime 0.8.0 — 所有日期逻辑
tyme4kt 1.4.5 — 农历、节气、传统节日
sketch 4.4.0 — GIF 显示（sketch-compose + sketch-animated-webp）

性能追踪标记

ComposeTrace.kt 提供自定义 Perfetto/Systrace 标记，关键标记名：

MonthView:Compose / YearView:Compose
CalendarPager:Page:* / WeekPager:Page
VM:collapseProgress:*
YearGridView:*

详见 DEVELOPMENT.md。

参考文档

文件	内容
`CLAUDE.md`	完整架构说明、组件树、动画机制、Pager 映射逻辑
`DEVELOPMENT.md`	性能追踪、Baseline Profile、模拟器启动参数
`COMMENTS.md`	KDoc 规范、注释原则、反模式清单
`app/AGENTS.md`	`:app` 模块细则
`core/AGENTS.md`	`:core` 模块细则
`macrobenchmark/AGENTS.md`	Baseline Profile 模块细则

3.6 KiB Raw Blame History Unescape Escape