Repository navigation
Releases
DexAdapt 0.13.0:可信摘要票据与阶段表通知
DexAdapt 0.13.0
跨进程可信摘要票据与有界在途合并;阶段表就绪通知带服务代际/序号和完整身份校验,保留断连恢复与轮询。
新增Android运行时通道、ZIP/SHA/原生初始化及逐符号包容/独占耗时和CPU计时;相同绑定更替令牌时转移原始首效,隔离迟到回执。
指定验证已完成:
- 现有25个真实APK的Dexlib/DexKit逐项一致,12440个解析条目、0缺失;未找包或替换红米宿主。
- 红米现有哔哩9190400、小红书9541801,每版本/宿主/场景20轮交替,共400个有效场景;中断及额外尝试另列。
- 认证通道可用、双方摘要冷时,新版每轮完整摘要只计算1次;仅宿主摘要冷时为0次,通道不可用时安全回退2次。
- 完整表交付到绑定P95:哔哩57.927ms、小红书298.367ms。
- 通道确认就绪且模块摘要命中时,原始首效补报P95:哔哩115.345ms、小红书162.307ms;原始纳秒时间逐项相同。
- 同一最终哔哩APK通过20项原包ART冷启动、212项隔离Android运行时断言;完整单测、Lint、长期签名及内容门禁通过。
双进程和摘要都冷的额外场景中,本机早期Provider会返回Unknown authority:按不可用通道处理,仍需两侧独立核验。没有为减少计数接受宿主自报SHA,也没有更改系统后台启动权限。此边界保留在结果中,不能外推为所有冷启动都只计算一次。
清表后的首效包含实际页面触发及自动化准备等待;绑定、准备刷新、刷新后效果和全过程分别统计。静态25包对照与本机两宿主实测分别记录。
已恢复临时设置及框架镜像,保留宿主数据,卸载测试程序。最终手机安装字节与附件一致。附件含校验值、分段/逐符号计时、完整测量及双引擎对照。
DexAdapt 0.12.0:就绪补报与摘要代际
本次接入 DexAdapt 0.12.0:
- 已确认桥接就绪后唤醒待发箱,保留原绑定与首效观察时间;旧在途失败不会覆盖就绪唤醒。
- 续发只更新交付令牌,复用符号链接缓存,不重复安装 Hook。
- 私有目录按系统安装代际及全部有序 APK 文件身份复用已完整验证的 DEX 摘要;换包、改写、拆分顺序变化或缓存损坏时重读。
附件提供 25 个现有 APK 的 Dexlib/DexKit 逐项对照、红米每版本每场景至少 20 次交替测试、分列系统确认的中位数/P95,以及 SHA-256。红米沿用现有宿主与数据。
DexAdapt 0.11.0:前台恢复与端到端计时
DexAdapt 0.11.0:前台优先复用经完整 DEX 身份验证的表,缺表才安排后台适配。宿主不再固定等待 600 ms。每次启动单独记时;桥接恢复后补送原始绑定和实际首效时间。
25 个真实 APK 的 Dexlib 和 DexKit 结果逐项一致。附件提供双引擎对照、红米计时与 SHA-256;红米使用现有宿主,系统确认等待单列。
本次发布包含 CLI 的 ZIP 和 TAR.GZ 分发包。
DexAdapt 0.10.0:共用恢复状态机
DexAdapt 0.10.0 统一了宿主恢复状态机和分段计时。两款模块接入同一套逻辑:
- 模块重启后可为同一张已验证的完整表续发令牌,无需重新扫描。
- 桥接恢复后自动补送首次实际效果,保留原观察时间;重复失败回执只安排一次重试。
- 按同一单调时钟记录排队、身份核验、优先阶段、表交付、宿主绑定和首次效果。
25 个真实 APK 的 Dexlib、DexKit 对照共 12,440 项命中,逐项一致。附件中的红米验收记录区分系统一次性唤起确认和功能回执补报。单次前后计时不作为提速结论。
DexAdapt 0.9.0:宿主恢复回执与安装摘要
DexAdapt 0.9.0 改进宿主升级后的自动恢复,并区分适配表交付、宿主绑定与功能首次实际生效。
- 恢复回执绑定完整 DEX 身份和查询目录,原子区分首次确认、重复确认和拒绝;持久适配表不保存进程令牌,模块重启后重新交付。
- 安装摘要按宿主独立复用。安装变更可立即使进行中的读取失效;同一文件被原地改写并恢复修改时间时,也会重新校验。
- 增加回执并发重发、安装中断、摘要失效及跨进程令牌的回归覆盖。
验证
- 全量 Gradle 测试通过;ZIP、TAR.GZ 解包后的内容一致,CLI 启动通过。
- 25 个真实 APK(哔哩哔哩 10 个、小红书 15 个)在 Dexlib、DexKit 上分别解析,12,440 项命中结果与内置基准逐项一致。哔哩哔哩
9190200命中 320 项,6 项不适用,0 项缺失。 - 独立 Android 环境验证了缓存命中、同一秒内改写后的重读,以及过期身份回执的拒绝。本次发布未在红米上重跑正式宿主的换包场景。
下载
dexadapt-0.9.0.zip/dexadapt-0.9.0.tar.gz:CLI 分发包,二选一。dexadapt-0.9.0-apk-parity.json:25 个 APK 的双引擎对照结果。SHA256SUMS.txt:两个分发包和对照报告的 SHA-256。
DexAdapt 0.8.0:宿主升级后的分阶段恢复
统一宿主升级、首次打开、模块启动、周期检查和重试的调度;完整 DEX 身份不匹配时拒绝用旧表。已开启且可热安装的功能及其依赖优先扫描,只有完整表持久化。降级可复用身份完全相同的表。
9 个哔哩哔哩和 15 个小红书真实 APK,Dexlib / DexKit 与发布基准逐项一致,共 12,120 个成功位置。
| 隔离 ART 场景 | 结果 | 首个功能确认 | 整轮 |
|---|---|---|---|
| 首次打开 | SCANNED | 12041.5 ms | 15086.9 ms |
| 扫描中断(阶段表已交付) | FAILED | 6364.5 ms | 6421.9 ms |
| 重建协调器后重试 | SCANNED | 5934.3 ms | 8221.3 ms |
| 同版本换包 | SCANNED | 6428.0 ms | 8626.0 ms |
| 连续升级 | SUPERSEDED | — | 0.9 ms |
| 连续升级 | SCANNED | 5921.2 ms | 8336.5 ms |
| 降级 | REUSED | 3766.3 ms | 3766.3 ms |
隔离 Android 36 ART;真实哔哩哔哩 APK 和 Android DexKit,实际调用原包竖屏构造器。宿主安装事件、LSPosed 功能交付由探针驱动;同码换包由相同版本身份搭配两份原包 DEX 模拟。
Gradle:120 项通过、1 项条件跳过、0 项失败。
本次发布 DexAdapt 工具与运行库,现有模块需要按 UPGRADE_RUNTIME.md 接入,未重发两个模块。
DexAdapt 0.7.0:拆包缓存与增量解析
- 修复同名、同大小的 .apks / .xapk 误用旧拆包的问题;提取缓存按实际内容核对,损坏或缺失时重建。
- 矩阵按符号和递归依赖复用成功解析的位置,并记录解析及余量重算数量。
24 个真实 APK 的 Dexlib / DexKit 结果与发布基准表逐项一致;改一条规则后,增量与独立全量的符号表、余量也逐项一致。
| 样本 | 冷跑(含 DexKit) | 整表命中 | 改一条规则:增量 | 改一条规则:全量 |
|---|---|---|---|---|
| 哔哩哔哩(9 个) | 696.8 秒 | 14.1 秒 | 98.1 秒 | 307.4 秒 |
| 小红书(15 个) | 1054.2 秒 | 61.7 秒 | 170.5 秒 | 521.3 秒 |
冷跑使用空索引及空矩阵缓存。后两列均使用预热的 APK 索引,DexKit 在单独轮次复验。
Gradle:115 项通过、1 项跳过、0 项失败。明细见 benchmark-summary.json。
DexAdapt 0.6.0:多签名访问器与增量余量
本版补齐多签名 Kotlin 访问器和按符号复用的余量计算。访问器以当前宿主实际签名校验接收者与参数;目录变动时只重算变更及其下游的余量。
24 个实际 APK 的 Dexlib / DexKit 已知构建结果与随模块发布的基准表一致;缓存命中与单规则修改后的增量均逐项对照独立全量结果。
| 样本 | 冷跑(含 DexKit) | 整表命中 | 改一条规则后增量 | 同一规则改动全量重算 |
|---|---|---|---|---|
| 哔哩哔哩(9 个) | 591.7s | 16.3s | 130.1s | 269.1s |
| 小红书(15 个) | 841.0s | 63.2s | 180.3s | 407.0s |
冷跑使用空的 APK 索引和矩阵缓存;后两列使用同一份已预热的 APK 索引且均不重复跑 DexKit。整表命中仍核对 DEX 内容,打开的 Dexlib 索引数为 0。
在隔离 Android 36 模拟器,用真实哔哩哔哩 9.18.0 和 9.19.0 成功调用新旧竖屏构造器;倍速三参和四参均经生成访问器用测试目标验证成功返回。对真实 APK 倍速方法,裸进程未初始化宿主,生成访问器与直接反射抛出相同的宿主初始化错误。本轮没有启动完整宿主界面。
完整 Gradle 测试 111 项通过、1 项条件跳过;桌面 DexKit 原生库需要按 README 准备。附件 SHA-256 见 SHA256SUMS.txt。
DexAdapt 0.5.0:多签名适配与回归探查
同一个方法符号可以描述新旧签名。已知构建可按构建标识或完整 DEX 摘要选分支;未知构建只接受唯一目标,多个候选明确报错。
新增 CLI / MCP 的 probe,可以只检查改动的符号及其下游,对照旧查询列出目标变化、缺失和依赖链,无需计算余量。矩阵分别校验同构建下的双引擎结果和未知构建行为。
- 用哔哩哔哩国内版 9.18.0 与 9.19.0 实测同一个竖屏入口符号的新旧构造签名。
- 发布门禁对照哔哩哔哩国内版、Play 版与小红书的真实 APK,并验证 Dexlib / DexKit 结果。
- 使用
method.variants的 spec 需要dexadapt: 2。旧 spec 继续可读。使用方升级依赖后应重新编译和生成解析器摘要。
发行包包含离线 CLI 与文档;DexKit 桌面校验需要按 README 准备本机原生库。校验值见 SHA256SUMS.txt。
0.4.0 · 双模块运行时一致性
DexAdapt 0.4.0 · 双模块运行时一致性
- 契约判定独立绑定规则、包名/代码身份和真实目标,规则收紧后重新观察;范围规则拒绝NaN及无穷,保持查询缓存与判定缓存分离。
- base与代码split统一内容摘要,资源split不改变单代码摘要;安装集合快速身份包含包名及全部split元数据,表可记录宿主包名。
- 同版本码的渠道、包名和代码变体可在同一matrix中分列,manifest给出variantKey/tablePath及fresh/reused;独立余量见margin-by-build,parity始终新跑。
- 公共BindingTransaction按实际绑定和依赖变化重装,失败回退;启动阶段功能留待重开。SymbolLinker提供安装读取记录和单次调用一致快照。
- MCP长任务不阻塞ping/取消,取消只终止自己启动的任务;结构化结果/outputSchema、非零退出标错和有界输出齐备。stdio关闭取消任务,嵌入调用可显式drainOnEof。
- repair按保留锚点和条件比较候选,同等证据却指向不同目标时不自动猜;保留候选依据及原spec。
- 发布可强制要求外部跨模块样本manifest,防止缺样本跳过被当作验证通过。
验证:102项通过、1项条件跳过(额外R8混淆库基准缺专用输入),0失败/错误。四份真实小红书/哔哩APK关键角色两引擎一致;真实同码CN/Play9161100独立列、实际代码split变体的fresh/reused与重新DexKit对照通过。MCP实际子进程取消、退出码3和ping验证通过。
使用方需重新编译并更新固定提交。Android宿主效果以各模块的单独验收记录为准;本轮未操作物理手机,不将桌面解析或JVM回归表述为实机效果。分发包不附带宿主APK或私人资料。