查看“柚坛工具箱TXT线刷规范文档”的源代码

== 一、命名规范 ==
[[文件:TXT文件.png|居中|缩略图]]
柚坛工具箱线刷采用两个txt文件，其必须命名为 <code>*fastboot.txt</code> 或 <code>*fastbootd.txt</code>，<code>*fastboot.txt</code>将用于在fastboot（bootloader）模式下刷入文件，<code>*fastbootd.txt</code>将用于在fastbootd（用户空间fastboot）模式下刷入文件。

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

== 二、文件内容规范 ==

=== 使用默认镜像： ===
[[文件:TXT内容.png|居中|缩略图|469x469像素]]
如上图所示，文件内的第一行可以时设备代号识别，使用 <code>codebname:xxxx</code> 可以指定刷入的设备型号，以防止用户错刷。注意：冒号必须为英文冒号。

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

=== 指定镜像： ===
如下图所示，在每个分区的后面 <code>空一格或多格</code> 即可填写刷入至该分区的镜像相对于该TXT文件的相对路径，注意：相对路径前需保留 <code>/</code> 符号，以及文件拓展名（是的，可以指定非 <code>img</code> 格式的文件）
[[文件:FastbootTXT.png|居中|缩略图|366x366像素]]

=== 关于修补Boot： ===
当未对 <code>boot</code> 分区指定镜像时，用户可以在刷入时勾选 <code>添加Magisk</code> 选项在刷入时直接添加Root，当然你也可以选择指定一个Root好的Boot镜像。

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

== 三、关于fastbootd ==
[[文件:FastbootdTXT.png|居中|缩略图]]
如果您的ROM是刷入的Super分区，且无需在用户空间fastboot（fastbootd）模式下进行刷入操作的话可以忽略此部分。

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

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