柚坛工具箱TXT线刷规范文档

来自Uotan Wiki · 刷机百科
Mujianwu讨论 | 贡献2024年11月1日 (五) 20:42的版本
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)

一、命名规范

柚坛工具箱线刷采用两个txt文件,其必须命名为 *fastboot.txt*fastbootd.txt*fastboot.txt将用于在fastboot(bootloader)模式下刷入文件,*fastbootd.txt将用于在fastbootd(用户空间fastboot)模式下刷入文件。

文件名的前半部分可以采取 flashall 或者 updatefrom* 字样来描述文件的不同作用(即刷入不同的镜像部分),同时如果不同机型使用同一个包刷入的话,也可以在文件名的前半部分添加机型名称进行区分。

二、文件内容规范

使用默认镜像:

如上图所示,文件内的第一行可以时设备代号识别,使用 codebname:xxxx 可以指定刷入的设备型号,以防止用户错刷。注意:冒号必须为英文冒号。

随后即可在下面列出需要刷入的分区部分,默认情况下(如上图),只列明分区时将在txt的同目录下的 images 文件夹内寻找与分区命同名的 img 格式的镜像文件(该情况下必须同命,且必须为 img 格式),随后进行自动连续刷入。

指定镜像:

如下图所示,在每个分区的后面 空一格或多格 即可填写刷入至该分区的镜像相对于该TXT文件的相对路径,注意:相对路径前需保留 / 符号,以及文件拓展名(是的,可以指定非 img 格式的文件)

关于修补Boot:

当未对 boot 分区指定镜像时,用户可以在刷入时勾选 添加Magisk 选项在刷入时直接添加Root,当然你也可以选择指定一个Root好的Boot镜像。

注意:由于工具箱不支持对已修补的Boot镜像进行二次修补,请不要将已被修补的Boot镜像设置为默认文件!

三、关于fastbootd

如果您的ROM是刷入的Super分区,且无需在用户空间fastboot(fastbootd)模式下进行刷入操作的话可以忽略此部分。

*fastbootd.txt 中,文件格式与 *fastboot.txt 相同,但需要注意的是请不要在该文件中填写任何物理分区,即不在Super内部的分区。工具箱会根据内置的动态分区列表删除非活动槽位的分区(动态AB分区的设备),同时也会查找备份分区的存在并进行删除,以确保Super分区内部的空间足够。随后工具箱会根据 *fastbootd.txt 内列出的分区将要刷入的分区删除再新建,以确保刷入成功的可能性更大。

对于 *fastbootd.txt 文件,我们依然建议你加入机型验证,对于部分新版本只更新动态分区内较少的一部分时,用户可以通过 (update)*fastbootd.txt 仅刷入更新的部分,以减少刷机时间。