Quartz 4

🔍 搜索

FOLME_AAR_INTEGRATION

2 min read

任务：在 MiuiSystemUI_X 中集成新版 Folme AAR

将 Folme 动画库从 4.0.0-alpha03 升级到 4.0.0-alpha09，新版包含 FolmeTracer（Perfetto 异步 Trace + 详细 Log）功能。

打包产物

  • Folme AAR: /home/zbc/micode/miuix/library/folme/build/outputs/aar/folme-release.aar (403K, 版本 4.0.0-alpha09)
  • 该 AAR 中已包含 FolmeTracer.class（新增的 Trace + Log 工具类）

SystemUI 项目路径

/home/zbc/micode/MiuiSystemUI_X

需要修改的文件（共 3 处）

1. 替换预编译 AAR 文件

旧文件目录：

packages/SystemUI/miuix_library/prebuilts-alpha/miuix/folme/folme/4.0.0-alpha03/
├── AndroidManifest.xml
└── folme-4.0.0-alpha03.aar

操作：

  • 创建新目录 miuix/folme/folme/4.0.0-alpha09/
  • 将 /home/zbc/micode/miuix/library/folme/build/outputs/aar/folme-release.aar 拷贝为 folme-4.0.0-alpha09.aar
  • 同时拷贝 AndroidManifest.xml（可从旧目录复制，内容不变）
  • 旧版本目录可保留不删

2. 更新 gradle/libs.versions.toml（第 113 行）

旧: miuix-folme = { module = "miuix.folme:folme", version = "4.0.0-alpha03" }
新: miuix-folme = { module = "miuix.folme:folme", version = "4.0.0-alpha09" }

注意：只改 folme，animation（第 125 行）保持 4.0.0-alpha03 不变。

3. 更新 packages/SystemUI/miuix_library/prebuilts-alpha/Android.bp

两处路径需要更新（第 53 行和第 66 行）：

第 53 行:
旧: aars: ["miuix/folme/folme/4.0.0-alpha03/folme-4.0.0-alpha03.aar"],
新: aars: ["miuix/folme/folme/4.0.0-alpha09/folme-4.0.0-alpha09.aar"],

第 66 行:
旧: manifest: "miuix/folme/folme/4.0.0-alpha03/AndroidManifest.xml",
新: manifest: "miuix/folme/folme/4.0.0-alpha09/AndroidManifest.xml",

不需要修改的文件

  • 各模块 build.gradle（引用的是 libs.miuix.folme，版本跟随 toml 自动更新）
  • animation 相关文件（FolmeTracer 没有用到 animation 新 API，运行时向下兼容）

验证

集成完成后可在设备上验证：

adb shell setprop debug.folme.trace 1
adb shell kill $(adb shell pidof com.android.systemui)
adb logcat -s FolmeTracer   # 操作手机触发动画，应看到详细 Log 输出

背景文档（可选阅读）

  • Folme Tracer 完整设计文档：/home/zbc/micode/miuix/library/folme/FOLME_TRACER_GUIDE.md
  • Folme 架构参考：/home/zbc/micode/miuix/library/folme/FOLME_GUIDE.md

Graph View