Skip to content

v2.0.0

Choose a tag to compare

@github-actions github-actions released this 16 Nov 17:26
· 69 commits to master since this release

更新说明

本次发行版本为 v2.0.0。功能变更、兼容要求与能力边界见版本记录和中文项目首页。发布说明默认使用中文;命令、版本号与接口标识符保持原样。

本版变更

  • 破坏性变更:只保留 fxapk 一个名字。
    • 去掉 apkscan 命令别名,脚本里的 apkscan <子命令> 改为 fxapk <子命令>。
    • 导入包由 apkscan 改为 fxapk,不提供兼容层:import apkscan / python -m apkscan.cli 改为 import fxapk / python -m fxapk.cli;日志记录器名随之变为 fxapk.*。
    • 可选插件随之升级:fxapk-android-ui、fxapk-rea、fxapk-flutter 升为 0.2.0 并要求核心 >=2.0.0;旧版插件仍导入 apkscan,装在 2.0.0 上会加载失败,需一并升级;新插件不能装在 1.x 上。fxapk-asc 不导入核心,维持 0.1.2。
    • 有意保持不变,以免旧证据和本地状态失效:Frida 消息类型与控制台标签(apkscan-crypto 等)、归因图稳定 ID 的命名空间、工作目录缓存 .apkscan_cache/、重打包签名库 ~/.apkscan/、设备侧导出目录 /data/local/tmp/apkscan_db、测试用环境变量 APKSCAN_*。
    • 规则文件注释里的包名同步更新,ruleset_digest 因此与 1.x 不同;规则判据未变。
    • unpack 的 playbook 提示改为 fxapk analyze。
  • 发版门禁:tag 发版在上传前用即将上传的同一个 wheel 跑 tools/release_smoke.py(合成 APK 离线分析 → digest → 证据打包/校验 → 损坏副本必须非零),失败不上传、不重新构建;CI 的 wheel 冒烟跑同一脚本。
  • 文档:README 与 Android UI 指南的安装示例不再锁旧版本(此前 PyPI 页面仍示例 fxapk==1.25.0),版本专属内容只由发行说明模板按 tag 生成,测试拦截手写版本号。
  • Phase-2:triage 重读 inventory 已登记报告时,缺失、读不回、字节与登记哈希不符或顶层非对象,不再只写日志:写入 triage.json / queue.md 的 issues(phase2_report_missing|unreadable|hash_mismatch|not_object),triage / decide* / materialize / replay 默认退出 1,gate 的 G1 阻断。此前这类失败退出 0,并会让该 parent 被误判为跨包 advice 冲突。
  • 新增 DEVICE-ACCEPTANCE.md:授权专用测试机的手动验收步骤与记录项,只在采集路径改动或发版前跑,不进 CI。
  • 验证范围为合成回归、跨平台 CI 与发版前 wheel 冒烟;未做真机验收。

安装包

核心 fxapk 2.0.0 提供 wheel 与源码归档,并由本流程发布到 PyPI。可选插件均为独立版本,仅通过本页附件分发,不发布到 PyPI:fxapk-android-ui 0.2.0(Android CLI 与 adb 自备)、fxapk-rea 0.2.0(默认关闭,需在进程环境显式设置 FXAPK_ENABLE_REA=1;trace 另装 [trace] extra)、fxapk-asc 0.1.2(fxapk dex 隔离 worker,macOS 上以 memory_limit_unavailable 拒绝执行)、fxapk-flutter 0.2.0(离线 Flutter AOT 静态分析:仅 Android ARM64,须事先自备本地 Blutter 可执行文件与固定 Docker 镜像,分析不拉取镜像、不编译、不执行 APK;查询与证据包未脱敏,静态汇编与 URL 字面量不是实际网络传输证据)。核心要求 Python >=3.11,插件要求以其包元数据为准。

python -m pip install "fxapk==2.0.0"
python -m pip install ./fxapk_android_ui-0.2.0-py3-none-any.whl
python -m pip install ./fxapk_rea-0.2.0-py3-none-any.whl
python -m pip install ./fxapk_asc-0.1.2-py3-none-any.whl
python -m pip install ./fxapk_flutter-0.2.0-py3-none-any.whl
fxapk --version
fxapk ui --help
fxapk dex --help
fxapk flutter --help

以上命令在下载附件所在目录执行;仅安装需要的插件即可。REA 安装后保持关闭,
需明确启用时才为该进程设置 FXAPK_ENABLE_REA=1 并运行 fxapk rea --help。
trace 的可选依赖可通过
python -m pip install "./fxapk_rea-0.2.0-py3-none-any.whl[trace]" 安装。
插件不会自动启动浏览器、查询第三方或连接设备。本页附件含核心与四个可选插件共十个归档;插件归档不含 Blutter 可执行文件或 Docker 镜像,Flutter 分析也不会自动拉取或构建它们。

定点复核可另装 python -m pip install "fxapk[review]==2.0.0",包含 pyelftools、Capstone、cryptography 和 Unicorn。intake-fetch 仍需兼容的独立 fxfetch CLI;JADX、adb 与所选后端的 Frida 须自备。命令、状态与范围见离线复核和恢复链。这些入口不自动完成案件闭环或正式 PDF/XLSX 发布。

安装前用附件 SHA256SUMS.txt 核对全部归档。它们不是完整离线依赖包,安装可能下载声明依赖。许可见各归档内的 MIT 声明,第三方工具和依赖遵循各自许可。安卓 UI 指南。

来源与使用边界

本版标签对应提交 bb7b6c8a782edfc6665c5cc2fe713560fc05121a。验证范围以该提交的 CI、版本契约和实际发布结果为准,不据流程成功宣称真机或服务商账户已验收。

设备操作与第三方查询须在对应授权内执行;安装插件不会自动为 auto/capture CLI 接入 UI 观察。截图、布局、报告与诊断可能含敏感原值,digest 的有限脱敏不保证这些材料可直接外发。账户额度和权限以实际来源回执为准。