Android ROM Toolkit for Windows

当前版本：v1.2.6

介绍

一个面向 Windows 的 Android ROM 工具，简称 A.R.T。本项目基于原作者 ELF-RC 的 A.R.T 开源项目重构和扩展，保留原项目的许可证与致谢信息，现提供 Windows 图形界面、CLI 和 MCP 接口。

运行平台

• Windows 10/11 x64：默认使用 Windows 原生工具及 EXE 内置的 AVB 工具。常规操作不会启动 WSL；只有 OTA 扩展参数需要内置兼容 avbroot 时，才会按需通过 wsl.exe 调用它。完整 WSL 后端仍需在工具链页明确选择并保存，或设置 ART_BACKEND=wsl。

• Linux x86_64/arm64：继续使用原有 ELF 工具和 CLI 流程。

• Windows 原生工具目录可通过 ART_WINDOWS_TOOLS 指定，例如 E:\\MIO-KITCHEN-4.1.3-win\\bin\\Windows\\AMD64。

注意事项

• 非必要请不要授予工具SU ! ! !

• 请勿删除【工程目录/configs文件夹】，打包时所需的文件信息都在此处

• 工程路径建议使用英文和数字；GUI 支持 Unicode 输入。若第三方工具或 WSL 不接受 Unicode 路径，请将工程放在英文目录。

启动方式

python Scripts/main.py --gui  # 现代桌面界面
python Scripts/main.py --mcp  # MCP stdio 服务
python Scripts/main.py        # 原有 CLI

GUI 使用 PySide6/Qt 的原生桌面工作台，浅色主题为默认，可在“工具链 → 界面外观”中切换浅色/深色；主题偏好会保存到 art-res/ui-settings.json。图形界面覆盖 ROM ZIP、payload、super、IMG、WIN、DAT/DAT.BR 的导入、解包和回包，并提供 super 合成、RAW/Sparse 转换和工具链诊断。Windows 发布包使用 art-res/bin-win-amd64 中的原生工具；缺失的可下载工具可以在“工具链”页自动补齐。EXT4 校验工具 e2fsck.exe、resize2fs.exe 及依赖 DLL 放在独立的 e2fsprogs 子目录，通过 Cygwin Windows 运行库运行，无需 WSL。使用的 Windows 移植版为 1.44.5，若镜像采用该版本不支持的新特性，校验会明确失败，不会跳过或隐式切换到 WSL。MCP 工具包含同一套工程、导入、解包、回包和 super 合成功能。

Windows 打包：

python build.py

产物为 A.R.T-Windows-amd64.zip，解压后双击 art.exe 即可启动工作台，不会额外打开终端窗口。后台任务日志仍显示在界面中，--mcp 继续通过标准输入输出管道通信。

Windows AVB 与 OTA 签名

• avbtool 基于 AOSP 1.3.0，连同 RSA 签名库内嵌到 art.exe。签名、验签、镜像信息和去除 footer 无需另装 Python、OpenSSL 或 WSL。源码运行需安装 requirements.txt。

• “高级工具 → AVB 镜像签名”可选择无签名、内置 RSA2048 测试密钥、内置 RSA4096 测试密钥（默认）或自定义 PEM；RSA 算法自动匹配密钥位数。内置测试私钥随源码及 EXE 公开提供，正式发布签名请使用自己的密钥。

• 原生哈希树签名默认生成 AVB 内嵌 FEC。AOSP avbtool 的 FEC 数据由随包的 avbroot fec generate 生成，格式、交错布局和 roots 参数与 Android fec 工具一致；--do_not_generate_fec 仍可显式关闭。自动大小基于镜像逻辑大小计算并为哈希树、FEC 与 AVB footer 预留空间。

• 发布包附带官方 Windows x64 avbroot 3.34.1。缺失时在首次运行相应操作或“自动补齐 Windows 工具”中查询官方最新稳定版，验证 SHA256 与实际版本后安装。

• 发布包同时保留原项目的扩展 avbroot 构建。OTA 使用 --add-partition、--disable-avb 或原版 --super-mode 时，Windows 原生后端会自动调用这个内置兼容工具（--super-mode NAME 会转换为动态分区标记）；普通 OTA 替换、AVB 和 FEC 仍走 Windows 原生工具。扩展构建通过随包的 art-res/bin-amd64/avbroot 运行，Windows 需要启用 wsl.exe，无需在工具链页切换后端。

• 深浅色主题统一下拉列表的边框、文本、选中背景及禁用状态；签名失败会保留工具错误信息。

可用 art.exe --avbtool version 检查内置工具。发布前的真实工具检查：

python -m unittest discover -s tests -v
python tests/native_ext4_smoke.py path/to/art.exe
python tests/native_avb_smoke.py path/to/art.exe

工具预览

工程目录结构

DNA_工程名/
├── INPUT/                 # 原始输入区：放置 img、payload.bin、new.dat、br、win 等文件
├── OUT/                   # 最终输出区：合成的 img、new.dat、br、super.img、修补后的 boot 镜像
└── WORKSPACE/             # 可编辑工作区
    ├── config/            # 分区 fsconfig、SELinux contexts、镜像信息等合成 metadata
    ├── system/
    ├── vendor/
    └── 其他分区目录/

• INPUT 是只读输入区：工具不会主动删除、改名或覆盖其中的文件；所有中间文件写入 WORKSPACE

• 分区文件树与 config 均位于 WORKSPACE/，请勿手动删除 WORKSPACE/config/ 中需要回包的 metadata

• 最终合成产物输出到 OUT/

回包 metadata 自动补齐

新增或修改过的文件在回包时会自动补上缺失的合成 metadata，无需手写整条规则：

• fsconfig：缺失的路径按目录 0755、文件 0644（可执行目录下的二进制 0755、*.sh 0750）补齐

• SELinux contexts：为没有专属规则的路径补一行标签，继承顺序为

  1. .prop、.rc、.xml、.conf、.cfg、.ini、.json 等配置文件，继承同目录同类配置文件的标签

  2. 其他文件继承同目录常规文件的标签

  3. 目录继承同目录目录、再逐级向上继承父目录的标签

• 补齐的行追加在 WORKSPACE/config/<分区>_contexts.txt 末尾（libselinux 取最后一条匹配，因此它会覆盖分区级兜底规则），并回写到工程文件

• 标签不理想时直接编辑该文件对应行再回包即可，无需从路径开始重写上下文规则

构建

1.安装python3,pip

2.pip install -r requirements.txt --break-system-packages (这里更推荐使用虚拟环境)

3.执行./build.py构建

反馈

请直接提issue