盾牌座 UY

| English | 简体中文 |

该工具的目的是为了解决解包，打包，修改 img 麻烦的问题
使用该工具在 WSL 和 Ubuntu 测试均可使用，安装所需要的包：

sudo apt update
sudo apt install lz4 python3 openjdk-21-jdk device-tree-compiler

其它 Linux 内核系统待测试，推测都能正常工作，为工具给予权限：

chmod 777 -R ./*

然后即可启动工具，只需输入：

./start.sh

该工具仅支援 img 格式的分区文件，以及卡刷包文件中 payload.bin 的提取，老版本的其它格式的分区文件不支援，也不会支援
首次使用该工具，你一定要仔细阅读下面的说明，如果你不仔细阅读而提出在说明中有表述的内容，我会无视

---

主菜单

选择工作域：选中一个工作域，选中后，后续的操作都将基于该工作域的路径

建立工作域：建立一个工作域，任意命名，允许空格和中文，工作域的作用是限制使用范围

删除工作域：删除一个工作域

更改语言设置：支持简体中文与英文切换

退出程序

---

工作域菜单

分区文件提取：支持 EROFS、EXT、F2FS、VBMETA、DTBO、BOOT、PAYLOAD、SUPER、SPARSE 分区标识的文件提取（特别提示，Recovery.img 与 Boot.img 的文件标识均为 BOOT，所以它们都能被提取）。按 ALL 即可提取所有，按 S 即可启动简易识别，简易识别的作用是自动识别 SUPER 分区文件的子分区，以便于修改，提取分区文件列表只会展示可识别的分区，如果你发现你放入的分区文件不显示，说明工具不支持该分区文件的识别，之所以要这样实现，是因为不支持的文件显示在列表上毫无意义，目前简易识别支持标准的 SUPER 子分区识别，以及小米高通、小米 MTK、一加等，如果你的机型有其它特殊 SUPER 结构，向我反馈，或自行添加。

分区文件打包：打包提取后的分区文件，如果原本标识是 EROFS、EXT、F2FS，则打包后需要选择打包的格式，可选 EROFS、EXT、F2FS 打包格式，原本标识为支持格式中的其它，则无需选择，自动识别

SUPER 分区打包：首先要自行将打包的子分区文件放置到工作域目录的 Extracted-files/super 文件夹，然后使用该功能，动态分区类型要保持与原来的一致，假设你的机型是 VAB 动态分区，打包也得是 VAB 动态分区，而是否选择稀疏格式，这个可能取决于 ROM 是否支持，例如一加的官方系统，使用稀疏格式镜像会导致识别问题

一键修改：内置了 HyperOS, OneUI 的快速修改方案，对 HyperOS 支持内容较多，在 MIUI 14 及之后的版本修改是没有任何问题的，不支持老版本，老版本牵涉到卡米问题，如果仍然想修改，自行解决卡米代码的问题

构建刷机包：支持分卷与完整包压缩，大小自定义，机型代码需要严格遵守你的使用的机型，避免冲突，而默认打包名与工作域名称一致，本刷机包为线刷包，脚本默认禁用 AVB2.0 校验，因此无需额外修改

返回主菜单

退出程序

如何使用盾牌座 UY 来完成一个 ROM 的简易修改（这里以 HyperOS 为例子）？

1. 创建一个工作域，名称允许中文英文空格和 Windows 资源管理器允许的符号
2. 选中工作域
3. 将 img 或 payload.bin 文件移动到创建工作域目录当中，然后使用提取功能
4. 使用简易识别自动筛选出 SUPER 子分区，然后再使用全部提取
5. 使用一键修改，需要修改什么，自己看提示使用
6. 打包所有提取的分区文件，使用打包所有即可，打包 EROFS 还是 EXT4 取决于你的内核
7. 将打包的子分区移动到选中工作域 Extracted-files/super 里面
8. 使用 SUPER 打包功能，保证打包的动态分区与你的设备一致，大小会自动计算，根据提示来选择
9. 将打包好的 SUPER 分区移动到选中工作域的 Ready-to-flash/images 目录，注意“简易识别”已自动将其它分区移动到这！
10. 使用打包功能，这样一个修改的 ROM 制作完成

感谢：
1、 https://github.com/ColdWindScholar/TIK
2、 https://github.com/cubinator/ext4
3、 https://github.com/nmeum/android-tools
4、 https://github.com/cfig/Android_boot_image_editor
5、 https://github.com/nlitsme/extfstools 等等......