一、命名规范
柚坛工具箱线刷采用两个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
仅刷入更新的部分,以减少刷机时间。