Repository navigation
v6.13.0
✨ 新功能
新增「忽略深度」规则选项 #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/**
进一步降低后续重构导致架构边界回退的风险。