Skip to content

v6.13.0

Choose a tag to compare

@firesahc firesahc released this 04 Oct 17:52
· 10 commits to main since this release

✨ 新功能

新增「忽略深度」规则选项 #15

针对部分应用界面层级动态变化、导致原有 depth 路径定位失效的问题,新增 「忽略深度」 开关。

开启后,规则将跳过原有的 depth 双锚匹配,仅使用 Resource Name(资源名称) 进行定位,从而提高动态布局场景下的规则命中率。

  • 默认关闭,现有规则行为保持不变
  • 仅在规则存在 Resource Name 且不是 Repeatable 规则时提供该选项
  • 原有 depth 数据仍会保留,关闭开关后即可恢复原来的双锚匹配
  • 由于仅依赖资源名称,界面中存在多个相同资源 ID 的元素时可能出现误命中,请谨慎使用

⚡ 性能优化

优化 Resource Name 单锚匹配

修复旧规则在 Resource Name 匹配失败时可能进行两次 getIdentifier + findViewById 全树遍历的问题。

现在改为:

单次查找 → 可见性检查 → 结构检查 → 失败诊断

成功匹配和失败诊断复用同一个查找结果,在保持原有匹配语义及 fail-closed 行为不变的情况下减少重复遍历。

减少 Matcher 中的重复计算

优化规则匹配过程中对 depth、itemPath 以及结构化匹配字段的重复获取和数组复制。

同时优化失败日志生成过程,避免对同一规则反复调用 getter 和创建数组副本。

优化规则槽位查找

RuleRepository 在查找目标规则时,将目标 RuleSlotKey 从循环内部提取到循环外,避免重复构造及数组复制。

原有重复槽位的 last-wins 行为保持不变。

优化 IPC 规则快照体积

IPC 规则快照改用紧凑 JSON 序列化:

  • 快照不再使用 Pretty JSON,降低传输数据体积
  • 保留持久化 JSON 的可读格式
  • 缓解规则数量较多时接近 8 MiB 快照上限的问题
  • JSON 解析保持兼容,传输校验机制不变

🛡️ 兼容性与稳定性

ignoreDepth 数据向后兼容

新增规则字段不会破坏已有规则:

  • JSON 使用 ignore_depth 字段保存
  • 旧 JSON 缺少该字段时默认 false
  • Parcelable 数据采用尾部追加方式保存
  • 旧 Parcelable 数据读取时缺少该字段同样默认 false
  • 新增字段不会改变原有规则槽位身份

同时增加了相关 JSON、Parcelable、规则槽位及 Matcher 测试,确保 true/false 状态能够完整往返。

🏗️ 架构与工程改进

编辑器与运行时进一步解耦

新增 RuntimeRulePort,编辑器不再直接依赖具体的 RuleLifecycleManager / ViewController 实现。

预览、属性修改以及粒子遮罩等运行时操作统一通过 Activity 级 Runtime Session 完成,并保证同一 Session 内的应用与撤销操作使用一致的运行时拥有者。

分离备份/恢复工作流

规则备份与恢复逻辑独立为 backup 模块,与 control 权威控制层解耦。

同时将包名校验能力下沉至公共 util 层,减少模块之间的实现级依赖。

隔离 Xposed 平台适配

将隐藏的 PackageManager 访问以及 ContextWrapper 的 Xposed fallback 从通用工具中抽离至 platform/xposed。

普通 Android 工具类不再直接依赖 Xposed API,Xposed 平台能力集中在注入/平台适配层装配。

新增架构边界自动检查

新增架构边界验证脚本,并接入 CI。

CI 现在会自动检查:

  • Editor 不得直接依赖 Runtime 实现
  • Control 不得反向依赖 Editor 工作流
  • Backup 不得依赖 Control 实现
  • Engine 不得依赖 Xposed
  • Xposed API 依赖仅允许存在于 inject/** 和 platform/xposed/**

进一步降低后续重构导致架构边界回退的风险。