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

一、命名规范

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