Uotan Wiki · 刷机百科 - 用户贡献 [zh-cn]

EVBHelper使用合集

2025-10-27T08:07:56Z

Mujianwu：

[[文件:EVB1-1.png|居中|缩略图|597x597像素]]
[[文件:EVB1-2.png|居中|缩略图|583x583像素]]RFEL 页面支持环境设置：配置 rfel 可执行文件的路径。烧录参数：选择要烧录的固件映像文件（Firmware Image）和加载地址（Load Address，默认为 0x40008000）。烧录选项：可选地勾选 Initialize DDR（初始化 DDR）和 Reboot After Flash（烧录后重启）。控制面板：提供 Detect Device（检测设备）、Start Flash（开始烧录）、Restart Device（重启设备）和 Cancel Task（取消任务）等核心操作按钮。内存操作：允许用户直接读写内存地址（Address、Length、Value），支持 32 位读写。文件操作：支持将内存内容保存到文件（Read Output）或从文件加载内容到内存（Write Source）。实用工具：包括 Exec Code（执行代码）、Show SID（显示 SID）、Enable JTAG（启用 JTAG）、Run DDR Init（运行 DDR 初始化）和 Show Help（显示帮助）等低级 FEL 操作。
[[文件:EVB2-New.png|居中|缩略图|581x581像素]]
DTB 页面是一个设备树二进制文件（DTB）编辑器，用于查看、修改和管理嵌入式系统配置中关键的设备树文件。支持文件操作：Open DTB（打开 DTB 文件）、Save（保存）、Save As（另存为）。节点管理：左侧为设备树的节点结构视图，支持 New node name（新建节点）、Add child node（添加子节点）和 Delete node（删除节点）操作。属性编辑：右侧显示选中节点的属性列表，可以修改属性的名称、类型（Text、Hex 等）和值。例如，截图展示了 compatible 和 model 属性的编辑，以及 address-cells 和 size-cells 等二进制属性的查看。
[[文件:EVB3-New.png|居中|缩略图|585x585像素]]
GPT 页面是一个GUID 分区表（GPT）编辑器，用于查看和修改存储介质（如 SD 卡或 eMMC）的分区结构。支持文件操作：Open GPT（打开 GPT 文件/设备）、Save（保存）、Save As（另存为）。分区管理：支持 Add Partition（添加分区）和 Remove Partition（移除分区）。信息概览：显示磁盘的 Disk GUID、Usable LBA（可用逻辑块地址）、Total Partition Slots（总分区槽位）和 Array Checksum（校验和）等关键信息。分区详情：下方列表显示每个分区的详细信息，包括分区名称（Name）、类型 GUID（Type GUID）、分区 GUID（Partition GUID）、起始 LBA（First LBA）和结束 LBA（Last LBA），并提供 Required、Hidden、Read-Only 等分区属性的修改选项。[[文件:EVB4.png|居中|缩略图|593x593像素]]OpenixCard 页面是针对 OpenixCard 固件映像的打包和解包工具，主要用于处理包含多个分区的映像文件。可选择 .img 或 .fex 格式的映像文件进行解包，并提供 Generate cfg（生成配置文件）的选项。[[文件:EVB5.png|居中|缩略图|590x590像素]]OpenixIMG页面是针对 OpenixIMG 格式映像的解密、检查和重新打包工具，通常用于处理加密或特定格式的固件映像。提供 Unpack（解包）、Decrypt（解密）、Show Partitions（显示分区）、Inspect（检查）和 Pack（打包）等按钮，用于对 OpenixIMG 映像进行深层处理。

文件:EVB3-New.png

2025-10-27T07:18:53Z

Mujianwu：

EVB3-New

文件:EVB2-New.png

2025-10-27T07:18:24Z

Mujianwu：

EVB2-New

EVBHelper使用合集

2025-10-27T02:38:17Z

Mujianwu：创建页面，内容为“597x597像素 583x583像素 581x581像素 585x585像素 593x593像素 590x590像素”

[[文件:EVB1-1.png|居中|缩略图|597x597像素]]
[[文件:EVB1-2.png|居中|缩略图|583x583像素]]
[[文件:EVB2.png|居中|缩略图|581x581像素]]
[[文件:EVB3.png|居中|缩略图|585x585像素]]
[[文件:EVB4.png|居中|缩略图|593x593像素]]
[[文件:EVB5.png|居中|缩略图|590x590像素]]

文件:EVB5.png

2025-10-27T02:37:56Z

Mujianwu：

EVB5

文件:EVB4.png

2025-10-27T02:37:18Z

Mujianwu：

EVB4

文件:EVB3.png

2025-10-27T02:36:43Z

Mujianwu：

EVB3

文件:EVB2.png

2025-10-27T02:36:01Z

Mujianwu：

EVB2

文件:EVB1-2.png

2025-10-27T02:35:19Z

Mujianwu：

EVB1-2

文件:EVB1-1.png

2025-10-27T02:34:36Z

Mujianwu：

EVB1-1

首页

2025-10-27T02:29:57Z

Mujianwu：

<div style="text-align: center; padding: 40px 20px;">
<div style="display: inline-block; vertical-align: middle; padding: 20px; text-align: center;">
<h1 style="display: block; font-size: 42px; font-weight: bold; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin: 0 auto;">
欢迎来到[[文件:UotanWiki.png|250px]]刷机百科
</h1>
</div>

<p style="font-size: 20px; color: #6c757d; margin-top: 30px; line-height: 1.5; text-align: center;">
我们致力于打造<br>
<span style="font-weight: bold; color: #34495e;">更适合国人使用</span>、<span style="font-weight: bold; color: #34495e;">更贴近刷机本质</span>的<br>
玩机知识共享平台<br>
<br>
<span style="font-weight: bold; color: #34495e;">UoWiki现已上线[[提问与反馈板块]]，欢迎前往！╰(*°▽°*)╯
</p>
</div>
<div style="margin: 40px 0;">
<div style="display: flex; flex-wrap: wrap; justify-content: center; gap: 30px; margin: 0 auto; max-width: 1000px; text-align: center;">

<div style="flex: 1 1 200px; background: #f8f9fa; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div style="font-size: 18px; font-weight: bold; color: #333;">注册用户</div>
<div style="font-size: 24px; color: #007BFF;">{{NUMBEROFUSERS}}</div>
</div>

<div style="flex: 1 1 200px; background: #f8f9fa; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div style="font-size: 18px; font-weight: bold; color: #333;">活跃用户</div>
<div style="font-size: 24px; color: #28a745;">{{NUMBEROFACTIVEUSERS}}</div>
</div>

<div style="flex: 1 1 200px; background: #f8f9fa; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div style="font-size: 18px; font-weight: bold; color: #333;">条目总数</div>
<div style="font-size: 24px; color: #fd7e14;">{{NUMBEROFARTICLES}}</div>
</div>

<div style="flex: 1 1 200px; background: #f8f9fa; border-radius: 8px; padding: 20px; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div style="font-size: 18px; font-weight: bold; color: #333;">总编辑数</div>
<div style="font-size: 24px; color: #6f42c1;">{{NUMBEROFEDITS}}</div>
</div>

</div>
</div>

<div style="display: flex; flex-wrap: wrap; gap: 20px; max-width: 1200px; margin: 0 auto; padding: 20px;">


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">刷机入门</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[ADB与Fastboot|ADB 与 Fastboot]]<br>
• [[解锁Bootloader|解锁 Bootloader]]<br>
• [[刷入第三方Recovery|刷入第三方 Recovery]]<br>
• [[Recovery 刷机基本操作]]<br>
• [[获取Root权限|获取 Root 权限]]<br>
• [[Miflash线刷|MiFlash 线刷]]<br>
• [[使用柚坛工具箱进行线刷]]<br>
• [[ADB SideLoad]]<br>
• [[关于USB]]<br>
• [[Fastboot Update]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">进阶内容</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[Fastboot 命令]]<br>
• [[刷入任意单独镜像]]<br>
• [[Fastbootd|用户空间Fastboot]]<br>
• [[Project Treble|Project Treble（PT）]]<br>
• [[通用系统镜像|通用系统镜像（GSI）]]<br>
• [[GKI|GKI（通用内核映像）]]<br>
• [[Dynamic System Updates|DSU（Dynamic System Updates）]]<br>
• [[Android Verified Boot|AVB（Android Verified Boot）]]<br>
• [[Super Empty|Super empty]]<br>
• [[9008深度刷机|9008 深度刷机]]<br>
• [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]<br>
• [[提取分区]]<br>
• [[格式化分区]]<br>
• [[修改分区]]<br>
• [[QCN]]<br>
• [[Magiskboot]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">玩机软件（移动端）</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[NekoSMS]]<br>
• [[Chimi]]<br>
• [[Xposed]]<br>
• [[LSPosed]]<br>

</div>
</div>
</div>

<div style="display: flex; flex-wrap: wrap; gap: 20px; max-width: 1200px; margin: 0 auto; padding: 20px;">


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">玩机软件（PC）</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[UotanToolBoxNT使用合集|柚坛工具箱使用合集]]
• [[EVBHelper使用合集|EVBHelper（全志工具箱）使用合集]]

</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">系统修改</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[ADB命令|ADB 命令]]<br>
• [[HDC命令|HDC 命令]]<br>
• [[Magisk模块|Magisk 模块]]<br>
• [[LsPosed 模块|LSPosed 模块]]<br>
• [[KSU 模块]]<br>
• [[修改方案合集]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">Windows on ARM 相关</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[Renegade project]]<br>
• [[Renegade_Project移植指南]]<br>
• [[为手机刷入Windows|为手机刷入 Windows]]<br>
• [[更新驱动程序]]<br>
• [[Project-Aloha]]
• [[重新安装Windows|重新安装 Windows]]<br>
• [[LumiaWOA_设备]]
• [[Windows RT]]
• [[OnePlus SM8150]]
• [[Xiaomi POCO X3 NFC (surya) woa]]
• [[Redmi Note 9 Pro (miatoll) woa]]
• [[Xiaomi Civi (mona) woa]]
• [[一些常见问题及其解决方案]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">高级内容</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[AOSP]]<br>
• [[Android 分区详解]]<br>
• [[SELinux]]<br>
• [[如何解包 Android ROM]]<br>
• [[如何打包 Android ROM]]<br>
• [[柚坛工具箱TXT线刷规范文档]]<br>
• [[如何从源码构建 TWRP Recovery]]<br>
• [[如何从源码构建 Android ROM]]<br>
• [[使用edl.py|使用 edl.py]]<br>
• [[高通端口合集]]<br>
• [[ARM-v8a异常等级]]<br>
• [[为手机安装Linux|为手机安装 Linux]]<br>
• [[Git使用教程]]<br>
• [[Android内核编译入门]]<br>
• [[为新设备编写Recovery device tree]]<br>
• [[为新设备编写类原生device tree]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">数据资料查询</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[SOC平台型号对照表（联发科）]]<br>
• [[SOC平台型号对照表（高通骁龙）]]<br>
• [[小米手机设备代号名称对照表]]<br>
• [[华为手机型号对照表（中国）]]<br>
• [[荣耀手机型号对照表（中国）]]<br>
• [[各 Android 手机厂商 Bootloader 解锁 / 内核开源 / 解锁后保修情况]]
• [[部分Android厂商设备原厂Rom下载渠道收录]]<br>
• [[适用于原厂Rom刷机工具、固件烧录工具下载渠道收录]]
</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">知名类原生ROM</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[AfterLife]]<br>
• [[AlphaDroid]]<br>
• [[AOSPA]]<br>
• [[ArrowOS]]<br>
• [[crDroid]]<br>
• [[dotOS]]<br>
• [[DroidX]]<br>
• [[DerpFest]]<br>
• [[EvolutionX]]<br>
• [[exTHmUI]]<br>
• [[GrapheneOS]]<br>
• [[KaleidoscopeOS]]<br>
• [[LineageOS]]<br>
• [[Miku|Miku UI]]<br>
• [[Mokee]]<br>
• [[PixelExperience]]<br>
• [[RisingOS]]<br>
• [[YAAP]]
</div>
<div style="font-family: 'Microsoft YaHei', sans-serif; font-size: 14px; font-style: italic; color: #666; margin-top: 10px;">注：以上排序不分先后</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">知名玩机博主</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[极客湾Geekerwan]]<br>
• [[晨钟酱Official]]<br>
• [[江灵夏草]]<br>
• [[柚坛UOTAN]]
</div>
<div style="font-family: 'Microsoft YaHei', sans-serif; font-size: 14px; font-style: italic; color: #666; margin-top: 10px;">注：以上排序不分先后</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">知名玩机开发者</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[暮间雾]]<br>
• [[某贼]]<br>
• [[Amktiao]]<br>
• [[小太阳ACA]]<br>
• [[hellobbn]]
</div>
<div style="font-family: 'Microsoft YaHei', sans-serif; font-size: 14px; font-style: italic; color: #666; margin-top: 10px;">注：以上排序不分先后</div>
</div>


<div style="flex: 1 1 300px; background: #f8f9fa; border-radius: 8px; padding: 25px; box-shadow: 0 2px 5px rgba(0,0,0,0.05); margin-bottom: 20px; width: 100%;">
<h2 style="font-size: 32px; font-family: 'Microsoft YaHei', sans-serif; color: #2c3e50; border-bottom: 3px solid #3498db; padding-bottom: 10px; margin-bottom: 15px; font-weight: bold;">更多词条</h2>
<div style="font-family: 'Microsoft YaHei', sans-serif; line-height: 1.0; font-size: 24px;">
• [[设备代号收录集合]]<br>
• [[Android 版本合集]]<br>
• [[Linux mainlining]]<br>
• [[Windows on arm|WOA (Windows on arm)]]
</div>
</div>

</div>

UotanToolBoxNT使用合集

2025-04-21T15:05:00Z

Mujianwu：

== 柚坛工具箱 NT ==
[[文件:柚坛工具箱Logo.png|居中|缩略图]]

==== ''现代化 Android & OpenHarmony 工具箱'' ====

== ✨ 特点 ==
* 🍀 跨平台支持
* ✔️ 一站式平台
* 🌍 多语言支持
* 🚫 无广告
* 🛠 更多功能开发中...

== 🚩 项目架构 ==
[[文件:柚坛工具箱架构图.png|居中|缩略图|917x917像素]]

== 主页（设备信息显示） ==
[[文件:工具箱首页.png|居中|缩略图|530x530像素]]
主页可以显示设备的各种信息以及状态，还拥有重启功能，可以快速的将设备重启到各种模式。工具箱也支持多设备连接环境，可以选择工具箱连接的设备。

== 基本刷入 ==
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|526x526像素]]
基本刷入页面提供的主要功能是为设备解锁BootLoader引导加载程序，以及刷入Recovery镜像，它可以将Recovery镜像刷至A/B分区，也可以直接刷入，对于没有Recovery分区的设备，它也可以临时启动或将Recovery刷至Boot分区。该页面还可以安装ADB、Fastboot、9008等驱动/补丁。也还有修补Boot功能，可以在PC端使用Magisk修补Boot并快捷的刷入至设备中。

== 应用管理 ==
[[文件:柚坛工具箱应用管理.png|居中|缩略图|537x537像素]]
应用管理页面可以用列表的形式显示手机中已安装的应用程序，同时可以对软件进行运行、强行停止、激活、禁用、启用、提取安装包、卸载、保留数据卸载、清楚数据等操作，同时也可以通过选择APK文件来安装应用程序。

== 线刷 ==
[[文件:线刷.png|居中|缩略图|545x545像素]]
线刷页面可以为手机刷入自制ROM（刷机包），只需将需要在两种模式下刷入的分区列在一个TXT文档中，然后将需要刷入的镜像存放在TXT文档同目录下的image文件夹中，程序即可自动将列出镜像刷入至设备中。该页面也能通过ADB Sideload或Fastboot Update为手机刷入zip格式的刷机包，同时还支持选择小米线刷包中的刷机脚本。

== 自定义刷入 ==
[[文件:自定义刷入.png|居中|缩略图|547x547像素]]
自定义刷入页面可以为手机刷入任意镜像文件，预置了System、System_ext、Product、Odm、Vendor、Vendor_boot、Boot、Init_boot的直接刷入，也支持自定义分区的刷入。

== Scrcpy投屏 ==
[[文件:柚坛工具箱Scrcpy.png|居中|缩略图|559x559像素]]
Scrcpy投屏页面为Scrcpy投屏工具的启动器，可以通过多种设置来确定Scrcpy的启动参数。

== 格式化&提取 ==
[[文件:备份与提取.png|居中|缩略图|566x566像素]]
格式化&提取页面可以进行QCN的写入与提取（备份）、901D等端口的开启、Super_Empty的刷入以及格式化设备中的任意分区和提取（备份）任意分区，格式化分区时可选择EXT4、FAT32、exFAT、NTFS的文件系统。

== 杂项控制 ==
[[文件:柚坛工具箱杂项控制.png|居中|缩略图|577x577像素]]
杂项控制页面可以对手机的多个软件参数进行无极调节，如分辨率、DPI、电池状态、锁屏时间、状态栏图标、字体大小、动画速度等。

== 修改分区 ==
[[文件:柚坛工具箱修改分区.png|居中|缩略图|583x583像素]]
修改分区页面可以快捷的读取设备的分区信息并且可以自由的对设备的分区进行修改（删除或创建），也可以为部分设备解除分区数量限制。

== 设置 ==
[[文件:柚坛工具箱设置.png|居中|缩略图|588x588像素]]
设置页面可以调整工具箱的主题样式（浅色模式和深色模式），也可以调整背景样式。同时还有关于工具箱，在此处展示开发成员、软件版本等信息，也可以进行检查更新等操作。

== ✈️ 开始使用 ==

* 在 [https://github.com/Uotan-Dev/UotanToolboxNT/releases Github Release] 下载对应的最新版本。
** Windows版本的ZIP请使用第三方工具解压，带 Installer 的为安装程序。
** macOS运行须在终端执行命令：<code>sudo xattr -r -d com.apple.quarantine UotanToolbox.app</code>
** 龙芯版本推荐使用新世界，不确定旧世界是否能够正常使用。

== ⚙️ 开发环境 ==

=== 使用 Avalonia UI 开发 ===
{| class="wikitable"
!推荐环境
!扩展
|-
|Visual Studio 2022
|Avalonia for Visual Studio 2022
|}

== 二进制文件 ==
[https://github.com/Uotan-Dev/UotanToolboxNT.Binary 点击这里]获取使用的全部二进制文件

如果想要调试该项目，请将二进制文件放至<code>UotanToolboxNT\UotanToolbox\bin\Debug\net8.0\bin</code>目录下。

== Star 历史 ==

UotanToolBoxNT使用合集

2025-04-21T15:04:18Z

Mujianwu：

=== 柚坛工具箱 NT ===
[[文件:柚坛工具箱Logo.png|居中|缩略图]]

==== ''现代化 Android & OpenHarmony 工具箱'' ====

== ✨ 特点 ==

* 🍀 跨平台支持
* ✔️ 一站式平台
* 🌍 多语言支持
* 🚫 无广告
* 🛠 更多功能开发中...

== 🚩 项目架构 ==
[[文件:柚坛工具箱架构图.png|居中|缩略图|917x917像素]]

== 主页（设备信息显示） ==
[[文件:工具箱首页.png|居中|缩略图|530x530像素]]
主页可以显示设备的各种信息以及状态，还拥有重启功能，可以快速的将设备重启到各种模式。工具箱也支持多设备连接环境，可以选择工具箱连接的设备。

== 基本刷入 ==
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|526x526像素]]
基本刷入页面提供的主要功能是为设备解锁BootLoader引导加载程序，以及刷入Recovery镜像，它可以将Recovery镜像刷至A/B分区，也可以直接刷入，对于没有Recovery分区的设备，它也可以临时启动或将Recovery刷至Boot分区。该页面还可以安装ADB、Fastboot、9008等驱动/补丁。也还有修补Boot功能，可以在PC端使用Magisk修补Boot并快捷的刷入至设备中。

== 应用管理 ==
[[文件:柚坛工具箱应用管理.png|居中|缩略图|537x537像素]]
应用管理页面可以用列表的形式显示手机中已安装的应用程序，同时可以对软件进行运行、强行停止、激活、禁用、启用、提取安装包、卸载、保留数据卸载、清楚数据等操作，同时也可以通过选择APK文件来安装应用程序。

== 线刷 ==
[[文件:线刷.png|居中|缩略图|545x545像素]]
线刷页面可以为手机刷入自制ROM（刷机包），只需将需要在两种模式下刷入的分区列在一个TXT文档中，然后将需要刷入的镜像存放在TXT文档同目录下的image文件夹中，程序即可自动将列出镜像刷入至设备中。该页面也能通过ADB Sideload或Fastboot Update为手机刷入zip格式的刷机包，同时还支持选择小米线刷包中的刷机脚本。

== 自定义刷入 ==
[[文件:自定义刷入.png|居中|缩略图|547x547像素]]
自定义刷入页面可以为手机刷入任意镜像文件，预置了System、System_ext、Product、Odm、Vendor、Vendor_boot、Boot、Init_boot的直接刷入，也支持自定义分区的刷入。

== Scrcpy投屏 ==
[[文件:柚坛工具箱Scrcpy.png|居中|缩略图|559x559像素]]
Scrcpy投屏页面为Scrcpy投屏工具的启动器，可以通过多种设置来确定Scrcpy的启动参数。

== 格式化&提取 ==
[[文件:备份与提取.png|居中|缩略图|566x566像素]]
格式化&提取页面可以进行QCN的写入与提取（备份）、901D等端口的开启、Super_Empty的刷入以及格式化设备中的任意分区和提取（备份）任意分区，格式化分区时可选择EXT4、FAT32、exFAT、NTFS的文件系统。

== 杂项控制 ==
[[文件:柚坛工具箱杂项控制.png|居中|缩略图|577x577像素]]
杂项控制页面可以对手机的多个软件参数进行无极调节，如分辨率、DPI、电池状态、锁屏时间、状态栏图标、字体大小、动画速度等。

== 修改分区 ==
[[文件:柚坛工具箱修改分区.png|居中|缩略图|583x583像素]]
修改分区页面可以快捷的读取设备的分区信息并且可以自由的对设备的分区进行修改（删除或创建），也可以为部分设备解除分区数量限制。

== 设置 ==
[[文件:柚坛工具箱设置.png|居中|缩略图|588x588像素]]
设置页面可以调整工具箱的主题样式（浅色模式和深色模式），也可以调整背景样式。同时还有关于工具箱，在此处展示开发成员、软件版本等信息，也可以进行检查更新等操作。

== ✈️ 开始使用 ==

* 在 [https://github.com/Uotan-Dev/UotanToolboxNT/releases Github Release] 下载对应的最新版本。
** Windows版本的ZIP请使用第三方工具解压，带 Installer 的为安装程序。
** macOS运行须在终端执行命令：<code>sudo xattr -r -d com.apple.quarantine UotanToolbox.app</code>
** 龙芯版本推荐使用新世界，不确定旧世界是否能够正常使用。

== ⚙️ 开发环境 ==

=== 使用 Avalonia UI 开发 ===
{| class="wikitable"
!推荐环境
!扩展
|-
|Visual Studio 2022
|Avalonia for Visual Studio 2022
|}

=== 二进制文件 ===
[https://github.com/Uotan-Dev/UotanToolboxNT.Binary 点击这里]获取使用的全部二进制文件

如果想要调试该项目，请将二进制文件放至<code>UotanToolboxNT\UotanToolbox\bin\Debug\net8.0\bin</code>目录下。

== Star 历史 ==

文件:柚坛工具箱架构图.png

2025-04-21T15:00:01Z

Mujianwu：

柚坛工具箱架构图

文件:柚坛工具箱Logo.png

2025-04-21T14:57:24Z

Mujianwu：

柚坛工具箱Logo

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

2025-03-18T04:34:26Z

Mujianwu：

== 一、命名规范 ==
[[文件: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>codename: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内部的分区(从柚坛工具箱3.3版本开始，可以在<code>*fastbootd.txt</code>中填写物理分区)。工具箱会根据设备的动态分区列表删除非活动槽位的分区（动态AB分区的设备），同时也会查找备份分区(cow)的存在并进行删除，以确保Super分区内部的空间足够。随后工具箱会根据 <code>*fastbootd.txt</code> 内列出的分区将要刷入的分区删除再新建，以确保刷入成功的可能性更大。

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

=== 删除与创建虚拟分区 ===
从柚坛工具箱3.3.5版本开始，可以在<code>*fastbootd.txt</code>中定义分区的删除与创建，在分区名称的后面空格并添加<code>delete</code>或<code>create</code>定义删除与创建。该部分仅定义创建和删除，刷入镜像仍然需要另行指定。柚坛工具箱会自动检查需要创建或删除的分区是否存在，再进行对应的操作，不会重复创建或删除。示例如下图：
[[文件:创建虚拟分区.png|居中]]

文件:创建虚拟分区.png

2025-03-18T04:33:25Z

Mujianwu：

创建虚拟分区

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

2025-01-11T02:45:46Z

Mujianwu：

UotanToolBoxNT使用合集

2024-12-05T03:41:32Z

Mujianwu：创建页面，内容为“== 主页（设备信息显示） == 530x530像素主页可以显示设备的各种信息以及状态，还拥有重启功能，可以快速的将设备重启到各种模式。工具箱也支持多设备连接环境，可以选择工具箱连接的设备。 == 基本刷入 == 526x526像素基本刷入页面提供的主要功能是为设备解锁B…”

== 主页（设备信息显示） ==
[[文件:工具箱首页.png|居中|缩略图|530x530像素]]
主页可以显示设备的各种信息以及状态，还拥有重启功能，可以快速的将设备重启到各种模式。工具箱也支持多设备连接环境，可以选择工具箱连接的设备。

== 基本刷入 ==
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|526x526像素]]
基本刷入页面提供的主要功能是为设备解锁BootLoader引导加载程序，以及刷入Recovery镜像，它可以将Recovery镜像刷至A/B分区，也可以直接刷入，对于没有Recovery分区的设备，它也可以临时启动或将Recovery刷至Boot分区。该页面还可以安装ADB、Fastboot、9008等驱动/补丁。也还有修补Boot功能，可以在PC端使用Magisk修补Boot并快捷的刷入至设备中。

== 应用管理 ==
[[文件:柚坛工具箱应用管理.png|居中|缩略图|537x537像素]]
应用管理页面可以用列表的形式显示手机中已安装的应用程序，同时可以对软件进行运行、强行停止、激活、禁用、启用、提取安装包、卸载、保留数据卸载、清楚数据等操作，同时也可以通过选择APK文件来安装应用程序。

== 线刷 ==
[[文件:线刷.png|居中|缩略图|545x545像素]]
线刷页面可以为手机刷入自制ROM（刷机包），只需将需要在两种模式下刷入的分区列在一个TXT文档中，然后将需要刷入的镜像存放在TXT文档同目录下的image文件夹中，程序即可自动将列出镜像刷入至设备中。该页面也能通过ADB Sideload或Fastboot Update为手机刷入zip格式的刷机包，同时还支持选择小米线刷包中的刷机脚本。

== 自定义刷入 ==
[[文件:自定义刷入.png|居中|缩略图|547x547像素]]
自定义刷入页面可以为手机刷入任意镜像文件，预置了System、System_ext、Product、Odm、Vendor、Vendor_boot、Boot、Init_boot的直接刷入，也支持自定义分区的刷入。

== Scrcpy投屏 ==
[[文件:柚坛工具箱Scrcpy.png|居中|缩略图|559x559像素]]
Scrcpy投屏页面为Scrcpy投屏工具的启动器，可以通过多种设置来确定Scrcpy的启动参数。

== 格式化&提取 ==
[[文件:备份与提取.png|居中|缩略图|566x566像素]]
格式化&提取页面可以进行QCN的写入与提取（备份）、901D等端口的开启、Super_Empty的刷入以及格式化设备中的任意分区和提取（备份）任意分区，格式化分区时可选择EXT4、FAT32、exFAT、NTFS的文件系统。

== 杂项控制 ==
[[文件:柚坛工具箱杂项控制.png|居中|缩略图|577x577像素]]
杂项控制页面可以对手机的多个软件参数进行无极调节，如分辨率、DPI、电池状态、锁屏时间、状态栏图标、字体大小、动画速度等。

== 修改分区 ==
[[文件:柚坛工具箱修改分区.png|居中|缩略图|583x583像素]]
修改分区页面可以快捷的读取设备的分区信息并且可以自由的对设备的分区进行修改（删除或创建），也可以为部分设备解除分区数量限制。

== 设置 ==
[[文件:柚坛工具箱设置.png|居中|缩略图|588x588像素]]
设置页面可以调整工具箱的主题样式（浅色模式和深色模式），也可以调整背景样式。同时还有关于工具箱，在此处展示开发成员、软件版本等信息，也可以进行检查更新等操作。

文件:柚坛工具箱设置.png

2024-12-05T03:41:06Z

Mujianwu：

柚坛工具箱设置

文件:柚坛工具箱修改分区.png

2024-12-05T03:40:19Z

Mujianwu：

柚坛工具箱修改分区

文件:柚坛工具箱杂项控制.png

2024-12-05T03:39:30Z

Mujianwu：

柚坛工具箱杂项控制

文件:柚坛工具箱Scrcpy.png

2024-12-05T03:38:11Z

Mujianwu：

柚坛工具箱Scrcpy

文件:柚坛工具箱应用管理.png

2024-12-05T03:36:21Z

Mujianwu：

柚坛工具箱应用管理

首页

2024-12-05T03:32:49Z

Mujianwu：撤销Mujianwu（讨论）的修订版本909

== 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:UotanWiki.png|120px]]</span> · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot|ADB 与 Fastboot]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[Recovery 刷机基本操作]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]

== 进阶内容 ==
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Fastbootd|用户空间Fastboot]]
# [[Project Treble|Project Treble（PT）]]
# [[通用系统镜像|通用系统镜像（GSI）]]
# [[GKI|GKI（通用内核映像）]]
# [[Dynamic System Updates|DSU（Dynamic System Updates）]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[格式化分区]]
# [[修改分区]]
# [[QCN]]
# [[Magiskboot]]

== 柚坛工具箱 ==
# [[UotanToolBoxNT使用合集|柚坛工具箱使用合集]]

== 系统修改 ==
# [[ADB命令|ADB 命令]]
# [[HDC命令|HDC 命令]]
# [[Magisk模块|Magisk 模块]]
# [[LsPosed 模块|LSPosed 模块]]
# [[KSU 模块]]
# [[修改方案合集]]

== Mindows工具箱 ==
# [[为手机刷入Windows|为手机刷入 Windows]]
# [[更新驱动程序]]
# [[重新安装Windows|重新安装 Windows]]
# [[一些常见问题及其解决方案]]

== 高级内容 ==
# [[AOSP]]
# [[Android 分区详解]]
# [[SELinux]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[柚坛工具箱TXT线刷规范文档]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[高通端口合集]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
# [[Android内核编译入门]]
# [[为新设备编写Recovery device tree]]
# [[为新设备编写类原生device tree]]

== 知名类原生ROM ==
# [[AfterLife]]
# [[AlphaDroid]]
# [[AOSPA]]
# [[ArrowOS]]
# [[crDroid]]
# [[dotOS]]
# [[DroidX]]
# [[DerpFest]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[KaleidoscopeOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingOS]]
# [[YAAP]]
注：以上排序不分先后

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
注：以上排序不分先后

== 知名玩机开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]
注：以上排序不分先后

== 更多词条 ==
# [[设备代号收录集合]]
# [[Android 版本合集]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

首页

2024-12-05T03:30:19Z

Mujianwu：

== 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:UotanWiki.png|120px]]</span> · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot|ADB 与 Fastboot]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[Recovery 刷机基本操作]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]

== 进阶内容 ==
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Fastbootd|用户空间Fastboot]]
# [[Project Treble|Project Treble（PT）]]
# [[通用系统镜像|通用系统镜像（GSI）]]
# [[GKI|GKI（通用内核映像）]]
# [[Dynamic System Updates|DSU（Dynamic System Updates）]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[格式化分区]]
# [[修改分区]]
# [[QCN]]
# [[Magiskboot]]

== 系统修改 ==
# [[ADB命令|ADB 命令]]
# [[HDC命令|HDC 命令]]
# [[Magisk模块|Magisk 模块]]
# [[LsPosed 模块|LSPosed 模块]]
# [[KSU 模块]]
# [[修改方案合集]]

== Mindows工具箱 ==
# [[为手机刷入Windows|为手机刷入 Windows]]
# [[更新驱动程序]]
# [[重新安装Windows|重新安装 Windows]]
# [[一些常见问题及其解决方案]]

== 高级内容 ==
# [[AOSP]]
# [[Android 分区详解]]
# [[SELinux]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[柚坛工具箱TXT线刷规范文档]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[高通端口合集]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
# [[Android内核编译入门]]
# [[为新设备编写Recovery device tree]]
# [[为新设备编写类原生device tree]]

== 知名类原生ROM ==
# [[AfterLife]]
# [[AlphaDroid]]
# [[AOSPA]]
# [[ArrowOS]]
# [[crDroid]]
# [[dotOS]]
# [[DroidX]]
# [[DerpFest]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[KaleidoscopeOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingOS]]
# [[YAAP]]
注：以上排序不分先后

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
注：以上排序不分先后

== 知名玩机开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]
注：以上排序不分先后

== 更多词条 ==
# [[设备代号收录集合]]
# [[Android 版本合集]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

首页

2024-12-05T03:22:24Z

Mujianwu：

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

2024-11-01T12:42:31Z

Mujianwu：

== 一、命名规范 ==
[[文件: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> 仅刷入更新的部分，以减少刷机时间。

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

2024-11-01T12:34:11Z

Mujianwu：创建页面，内容为“== 一、命名规范 == 缩略图柚坛工具箱线刷采用两个txt文件，其必须命名为 *fastboot.txt 或 *fastbootd.txt，*fastboot.txt将用于在fastboot（bootloader）模式下刷入文件，*fastbootd.txt将用于在fastbootd（用户空间fastboot）模式下刷入文件。文件名的前半部分可以采取 flashall 或者 updatefrom* 字样来描述文件的不同作用（即刷入不同的镜像部分）…”

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

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

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

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

指定镜像：

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

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

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

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

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

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

文件:FastbootTXT.png

2024-11-01T12:33:05Z

Mujianwu：

FastbootTXT

文件:FastbootdTXT.png

2024-11-01T12:03:22Z

Mujianwu：

FastbootdTXT

文件:TXT内容.png

2024-11-01T11:16:06Z

Mujianwu：

TXT内容

文件:TXT文件.png

2024-11-01T11:01:05Z

Mujianwu：

TXT文件

首页

2024-11-01T10:57:13Z

Mujianwu：/* 高级内容 */

== 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:UotanWiki.png|120px]]</span> · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot|ADB 与 Fastboot]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[Recovery 刷机基本操作]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]

== 进阶内容 ==
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Fastbootd|用户空间Fastboot]]
# [[Project Treble|Project Treble（PT）]]
# [[通用系统镜像|通用系统镜像（GSI）]]
# [[GKI|GKI（通用内核映像）]]
# [[Dynamic System Updates|DSU（Dynamic System Updates）]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[格式化分区]]
# [[修改分区]]
# [[QCN]]
# [[Magiskboot]]

== 系统修改 ==
# [[ADB命令|ADB 命令]]
# [[HDC命令|HDC 命令]]
# [[Magisk模块|Magisk 模块]]
# [[LsPosed 模块|LSPosed 模块]]
# [[KSU 模块]]
# [[修改方案合集]]

== Mindows工具箱 ==
# [[为手机刷入Windows|为手机刷入 Windows]]
# [[更新驱动程序]]
# [[重新安装Windows|重新安装 Windows]]
# [[一些常见问题及其解决方案]]

== 高级内容 ==
# [[AOSP]]
# [[Android 分区详解]]
# [[SELinux]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[柚坛工具箱TXT线刷规范文档]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[高通端口合集]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
# [[Android内核编译入门]]
# [[为新设备编写Recovery device tree]]
# [[为新设备编写类原生device tree]]

== 知名类原生ROM ==
# [[AfterLife]]
# [[AlphaDroid]]
# [[AOSPA]]
# [[ArrowOS]]
# [[crDroid]]
# [[dotOS]]
# [[DroidX]]
# [[DerpFest]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[KaleidoscopeOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingOS]]
# [[YAAP]]
注：以上排序不分先后

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
注：以上排序不分先后

== 知名玩机开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]
注：以上排序不分先后

== 更多词条 ==
# [[设备代号收录集合]]
# [[Android 版本合集]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

Android 分区详解

2024-08-18T14:14:48Z

Mujianwu：

'''Android 设备包含若干个分区，这些分区在Android启动和运行过程中发挥不同的作用。'''

== 常见分区详解 ==

=== '''<code>boot</code> 分区'''： ===
'''此分区包含一个内核映像，使用 <code>mkbootimg</code> 创建。您可以使用虚拟分区直接刷写任意映像，而无需刷写新的 boot 分区。此分区还包含在 Android 13 之前发布的设备中的通用 ramdisk。'''

* kernel：<code>kernel</code> 虚拟分区通过将新内核映像写入旧内核映像来覆盖内核（<code>zImage</code>、<code>zImage-dtb</code>、<code>Image.gz-dtb</code>）。如果提供的开发内核不兼容，则可能需要使用关联的内核模块更新 <code>vendor</code>、<code>system</code> 或 <code>dtb</code> 分区（如果存在）。

* ramdisk：<code>ramdisk</code> 虚拟分区通过将新 ramdisk 映像写入旧 ramdisk 映像来覆盖 ramdisk。

=== '''<code>init_boot</code> 分区'''： ===
'''此分区包含发布时搭载 Android 13 及更高版本的设备的通用 ramdisk。'''

=== '''<code>system</code> 分区'''： ===
'''此分区包含 Android 框架。'''

=== '''<code>system_ext</code> 分区'''： ===
'''由谷歌在 Android 11添加的一个新分区，可以使用 <code>system</code> 资源'''

=== '''<code>recovery</code> 分区'''： ===
'''此分区会存储在 OTA 过程中启动的恢复映像。支持无缝更新的设备可以将恢复映像存储为 <code>boot</code> 或 <code>init_boot</code> 映像中包含的 ramdisk（而不是单独的映像）。'''

'''注意：某些厂商的VAB分区结构设备不包含recovery分区，他们会将recovery分区与boot分区合并，因此当你需要刷入第三方Recovery时需要使用命令：<code>fastboot boot boot.img(具体名称自定)</code>'''

=== '''<code>cache</code> 分区'''： ===
'''此分区会存储临时数据，如果设备使用无缝更新，则此分区是可选的。cache 分区并非必须可从引导加载程序写入，但必须可清空。此分区大小取决于设备类型和 <code>userdata</code> 上的可用空间。通常，50 MB 至 100 MB 就足够了。'''

=== '''<code>misc</code> 分区'''： ===
'''此分区供 recovery 分区使用，大小为 4 KB 或更大。'''

=== '''<code>userdata</code> 分区'''： ===
'''此分区包含用户安装的应用和数据，包括自定义数据。'''

=== '''<code>metadata</code> 分区'''： ===
'''此分区用于在设备使用元数据加密时存储元数据加密密钥。大小为 16 MB 或更大。此分区未经加密，且系统不会对其数据拍摄快照。数据会在设备恢复出厂设置时被清空。此分区的使用受到严格限制。'''

=== '''<code>odm</code> 分区'''： ===
'''此分区包含原始设计制造商 (ODM) 对系统芯片 (SoC) 供应商板级支持包 (BSP) 的自定义设置。利用此类自定义设置，ODM 可以替换或自定义 SoC 组件，并在硬件抽象层 (HAL) 上为板级组件、守护程序和 ODM 特定的功能实现内核模块。此分区是可选的；通常情况下，它用于存储自定义设置，以便设备可以针对多个硬件 SKU 使用单个供应商映像。'''

=== '''<code>odm_dlkm</code> 分区'''： ===
'''此分区专门用于存储 ODM 内核模块。将 ODM 内核模块存储在 <code>odm_dlkm</code> 分区（而不是 <code>odm</code> 分区）中后，无需更新 <code>odm</code> 分区即可更新 ODM 内核模块。'''

=== '''<code>vendor</code> 分区'''： ===
'''此分区包含一些厂商私有的二进制文件以及驱动等内容，用于实现厂商特定功能以及服务，例如图像传感器，音频，显示等，具体作用可以参考于ODM分区，而在各大厂商的系统维护中，如今一加（OnePlus），小米（Xiaomi）等厂商也开始使用ODM分区来存放他们的私有驱动文件，即将 /odm 作为另一个 /vendor 分区处理。'''

=== '''<code>vendor_dlkm</code> 分区'''： ===
'''此分区专门用于存储供应商内核模块。将供应商内核模块存储在 <code>vendor_dlkm</code> 分区（而不是 <code>vendor</code> 分区）中后，无需更新 <code>vendor</code> 分区即可更新内核模块。'''

=== '''<code>radio</code> 分区'''： ===
'''此分区包含无线装置映像，只有包含无线装置且在专用分区中存储无线装置专用软件的设备才需要此分区。'''

=== '''<code>tos</code> 分区'''： ===
'''此分区用于存储 Trusty 操作系统的二进制映像文件，仅在设备包含 Trusty 时使用。Trusty 是 Google 的可信执行环境 (TEE) 操作系统实现，与 Android 并行运行。'''

=== '''<code>pvmfw</code> 分区'''： ===
'''此分区会存储受保护的虚拟机固件 (pvmfw)，即在受保护的虚拟机中运行的第一个代码。如需了解详情，请参阅受保护的虚拟机固件。'''

== System-as-root ==
在 Android 9 中，非 A/B 设备应采用 system-as-root，以便通过系统专用 OTA 进行更新。

'''注意：如果设备使用的是 A/B 分区架构，则无需做出任何改动。'''

与将 <code>/boot</code> 改为<code>recovery</code>分区的A/B设备不同，非A/B设备必须保留单独的<code>/recovery</code> 分区，因为它们没有后备插槽分区（例如，从 <code>boot_a</code> 切换到 <code>boot_b</code>）。如果在非A/B 设备上移除 <code>/recovery</code>并使其与A/B架构类似，那么在<code>/boot</code>分区更新失败时，恢复模式可能会遭到破坏。因此，对于非A/B设备来说，<code>/recovery</code>分区必须作为单独的分区存在（不同于非A/B设备的<code>/boot</code>），这意味着恢复映像将继续延迟更新（即如同 Android 9 之前的设备中那样）。

对于SAR设备与先前的旧设备，最明显的区别便在于分区的挂载点上，见

'''（非AB设备）'''
[[文件:安卓SAR.png|缩略图|963x963像素|居中]]
== AB分区与无缝更新 ==
Android 有两种更新机制：A/B（无缝）更新和非 A/B 更新，支持无缝更新的系统分区类型有两种，一种是AB分区，一种是VAB分区。

'''安卓系统从7.0开始引入新的OTA升级方式，叫做A/B系统。A/B系统就是设备上有A和B两套可以工作的系统（用户数据只有一份，为两套系统共用），而这样做的好处就是，当OTA进行失败时可以直接切换到另外一个未经OTA的槽位，从而防止设备变砖，而缺点也很明显——两套系统分区意味着其占据多原来一倍的大小。'''

'''而在2020年9月9日，谷歌正式发布了Android11 代号 Android R，而伴随其发布，谷歌也向各大厂商几乎强制安利了一项技术，出厂安卓11的机型必须使用VAB架构 Android Virtual A/B ,而在后续版本Android 12/13 中又增加了 VABC (Virtual A/B with Compression)，增加了压缩功能。'''

'''首先让我们来看一下传统分区与VAB分区的结构'''
[[文件:安卓分区结构对比2.png|缩略图|1029x1029像素|居中]]

'''也就是说，在AB分区的设备中，system_a和system_b等ab分区是真实存在的，他们会占用空间，而在VAB中(以下以默认槽位A为例)，system_a和system_b并非同时存在，因此不会占据大量空间。无缝更新最大的优点在于：几乎无感，安全。'''

OTA 更新可以在系统运行期间进行，不会打断正常的使用。在更新写入完成后，只需要重启一次切换槽位即可完成系统更新。如果 OTA因为刷机失败等原因导致无法启动，将继续启动先前的操作系统。

更新包可以流式传输到 A/B 设备，因此在安装之前不需要先下载更新包。流式更新意味着用户没有必要在 /data 或 /cache 上留出足够的可用空间以存储更新包。

相比之下A-Only设备则没有上述优点，因为只有一套系统分区，如果OTA失败则会直接导致设备无法开机

'''空间占用对比：'''

[[文件:谷歌提供的图片.png|缩略图|897x897px|居中]]

== 参考资料： ==
①安卓常见分区：https://source.android.com/docs/core/architecture/partitions?hl=zh-cn#standard-partitions

②安卓A/B系统分区：https://source.android.google.cn/docs/core/ota/ab?hl=zh-cn

③安卓分区布局：https://source.android.google.cn/docs/core/architecture/bootloader/system-as-root?hl=zh-cn#ramdisk

Android 分区详解

2024-08-18T14:13:59Z

Mujianwu：

Android 设备包含若干个分区，这些分区在Android启动和运行过程中发挥不同的作用。

部分 A/B 设备为了支持无缝更新，把 boot、system、vendor 和 radio 配置了两个槽位（如：<code>system_a</code>，<code>system_b</code>）。

== 常见分区详解 ==

=== '''<code>boot</code> 分区'''： ===
'''此分区包含一个内核映像，使用 <code>mkbootimg</code> 创建。您可以使用虚拟分区直接刷写任意映像，而无需刷写新的 boot 分区。此分区还包含在 Android 13 之前发布的设备中的通用 ramdisk。'''

* kernel：<code>kernel</code> 虚拟分区通过将新内核映像写入旧内核映像来覆盖内核（<code>zImage</code>、<code>zImage-dtb</code>、<code>Image.gz-dtb</code>）。如果提供的开发内核不兼容，则可能需要使用关联的内核模块更新 <code>vendor</code>、<code>system</code> 或 <code>dtb</code> 分区（如果存在）。

* ramdisk：<code>ramdisk</code> 虚拟分区通过将新 ramdisk 映像写入旧 ramdisk 映像来覆盖 ramdisk。

=== '''<code>init_boot</code> 分区'''： ===
'''此分区包含发布时搭载 Android 13 及更高版本的设备的通用 ramdisk。'''

=== '''<code>system</code> 分区'''： ===
'''此分区包含 Android 框架。'''

=== '''<code>system_ext</code> 分区'''： ===
'''由谷歌在 Android 11添加的一个新分区，可以使用 <code>system</code> 资源'''

=== '''<code>recovery</code> 分区'''： ===
'''此分区会存储在 OTA 过程中启动的恢复映像。支持无缝更新的设备可以将恢复映像存储为 <code>boot</code> 或 <code>init_boot</code> 映像中包含的 ramdisk（而不是单独的映像）。'''

'''注意：某些厂商的VAB分区结构设备不包含recovery分区，他们会将recovery分区与boot分区合并，因此当你需要刷入第三方Recovery时需要使用命令：<code>fastboot boot boot.img(具体名称自定)</code>'''

=== '''<code>cache</code> 分区'''： ===
'''此分区会存储临时数据，如果设备使用无缝更新，则此分区是可选的。cache 分区并非必须可从引导加载程序写入，但必须可清空。此分区大小取决于设备类型和 <code>userdata</code> 上的可用空间。通常，50 MB 至 100 MB 就足够了。'''

=== '''<code>misc</code> 分区'''： ===
'''此分区供 recovery 分区使用，大小为 4 KB 或更大。'''

=== '''<code>userdata</code> 分区'''： ===
'''此分区包含用户安装的应用和数据，包括自定义数据。'''

=== '''<code>metadata</code> 分区'''： ===
'''此分区用于在设备使用元数据加密时存储元数据加密密钥。大小为 16 MB 或更大。此分区未经加密，且系统不会对其数据拍摄快照。数据会在设备恢复出厂设置时被清空。此分区的使用受到严格限制。'''

=== '''<code>odm</code> 分区'''： ===
'''此分区包含原始设计制造商 (ODM) 对系统芯片 (SoC) 供应商板级支持包 (BSP) 的自定义设置。利用此类自定义设置，ODM 可以替换或自定义 SoC 组件，并在硬件抽象层 (HAL) 上为板级组件、守护程序和 ODM 特定的功能实现内核模块。此分区是可选的；通常情况下，它用于存储自定义设置，以便设备可以针对多个硬件 SKU 使用单个供应商映像。'''

=== '''<code>odm_dlkm</code> 分区'''： ===
'''此分区专门用于存储 ODM 内核模块。将 ODM 内核模块存储在 <code>odm_dlkm</code> 分区（而不是 <code>odm</code> 分区）中后，无需更新 <code>odm</code> 分区即可更新 ODM 内核模块。'''

=== '''<code>vendor</code> 分区'''： ===
'''此分区包含一些厂商私有的二进制文件以及驱动等内容，用于实现厂商特定功能以及服务，例如图像传感器，音频，显示等，具体作用可以参考于ODM分区，而在各大厂商的系统维护中，如今一加（OnePlus），小米（Xiaomi）等厂商也开始使用ODM分区来存放他们的私有驱动文件，即将 /odm 作为另一个 /vendor 分区处理。'''

=== '''<code>vendor_dlkm</code> 分区'''： ===
'''此分区专门用于存储供应商内核模块。将供应商内核模块存储在 <code>vendor_dlkm</code> 分区（而不是 <code>vendor</code> 分区）中后，无需更新 <code>vendor</code> 分区即可更新内核模块。'''

=== '''<code>radio</code> 分区'''： ===
'''此分区包含无线装置映像，只有包含无线装置且在专用分区中存储无线装置专用软件的设备才需要此分区。'''

=== '''<code>tos</code> 分区'''： ===
'''此分区用于存储 Trusty 操作系统的二进制映像文件，仅在设备包含 Trusty 时使用。Trusty 是 Google 的可信执行环境 (TEE) 操作系统实现，与 Android 并行运行。'''

=== '''<code>pvmfw</code> 分区'''： ===
'''此分区会存储受保护的虚拟机固件 (pvmfw)，即在受保护的虚拟机中运行的第一个代码。如需了解详情，请参阅受保护的虚拟机固件。'''

== 动态分区 ==
搭载 Android 11 及更高版本的设备可以支持动态分区，此类分区属于 Android 的用户空间分区系统，支持在无线下载 (OTA) 更新期间创建和销毁分区以及调整分区大小。使用此分区系统，您可以在无线下载 (OTA) 更新期间创建、销毁分区或者调整分区大小。借助动态分区，供应商无需担心各个分区（例如 <code>system</code>、<code>vendor</code> 和 <code>product</code>）的大小。取而代之的是，设备会分配一个 <code>super</code> 分区，其中的子分区可动态调整大小。各个分区映像不再需要为将来的 OTA 预留空间。相反，<code>super</code> 中剩余的可用空间还可用于所有动态分区。

== 关于 system-as-root ==
在 Android 9 中，非 A/B 设备应采用 system-as-root，以便通过系统专用 OTA 进行更新。

'''注意：如果设备使用的是 A/B 分区架构，则无需做出任何改动。'''

与将 <code>/boot</code> 改为<code>recovery</code>分区的A/B设备不同，非A/B设备必须保留单独的<code>/recovery</code> 分区，因为它们没有后备插槽分区（例如，从 <code>boot_a</code> 切换到 <code>boot_b</code>）。如果在非A/B 设备上移除 <code>/recovery</code>并使其与A/B架构类似，那么在<code>/boot</code>分区更新失败时，恢复模式可能会遭到破坏。因此，对于非A/B设备来说，<code>/recovery</code>分区必须作为单独的分区存在（不同于非A/B设备的<code>/boot</code>），这意味着恢复映像将继续延迟更新（即如同 Android 9 之前的设备中那样）。

对于SAR设备与先前的旧设备，最明显的区别便在于分区的挂载点上，见

'''（非AB设备）'''
[[文件:安卓SAR.png|缩略图|963x963像素|居中]]
== AB分区与无缝更新 ==
Android 有两种更新机制：A/B（无缝）更新和非 A/B 更新，支持无缝更新的系统分区类型有两种，一种是AB分区，一种是VAB分区。

'''安卓系统从7.0开始引入新的OTA升级方式，叫做A/B系统。A/B系统就是设备上有A和B两套可以工作的系统（用户数据只有一份，为两套系统共用），而这样做的好处就是，当OTA进行失败时可以直接切换到另外一个未经OTA的槽位，从而防止设备变砖，而缺点也很明显——两套系统分区意味着其占据多原来一倍的大小。'''

'''而在2020年9月9日，谷歌正式发布了Android11 代号 Android R，而伴随其发布，谷歌也向各大厂商几乎强制安利了一项技术，出厂安卓11的机型必须使用VAB架构 Android Virtual A/B ,而在后续版本Android 12/13 中又增加了 VABC (Virtual A/B with Compression)，增加了压缩功能。'''

'''首先让我们来看一下传统分区与VAB分区的结构'''
[[文件:安卓分区结构对比2.png|缩略图|1029x1029像素|居中]]

'''也就是说，在AB分区的设备中，system_a和system_b等ab分区是真实存在的，他们会占用空间，而在VAB中(以下以默认槽位A为例)，system_a和system_b并非同时存在，因此不会占据大量空间。无缝更新最大的优点在于：几乎无感，安全。'''

OTA 更新可以在系统运行期间进行，不会打断正常的使用。在更新写入完成后，只需要重启一次切换槽位即可完成系统更新。如果 OTA因为刷机失败等原因导致无法启动，将继续启动先前的操作系统。

更新包可以流式传输到 A/B 设备，因此在安装之前不需要先下载更新包。流式更新意味着用户没有必要在 /data 或 /cache 上留出足够的可用空间以存储更新包。

相比之下A-Only设备则没有上述优点，因为只有一套系统分区，如果OTA失败则会直接导致设备无法开机

'''空间占用对比：'''

[[文件:谷歌提供的图片.png|缩略图|897x897px|居中]]

== 参考资料： ==
①安卓常见分区：https://source.android.com/docs/core/architecture/partitions?hl=zh-cn#standard-partitions

②安卓A/B系统分区：https://source.android.google.cn/docs/core/ota/ab?hl=zh-cn

③安卓分区布局：https://source.android.google.cn/docs/core/architecture/bootloader/system-as-root?hl=zh-cn#ramdisk

Android 分区详解

2024-08-18T14:13:30Z

Mujianwu：

Android 设备包含若干个分区，这些分区在Android启动和运行过程中发挥不同的作用。

部分 A/B 设备为了支持无缝更新，把 boot、system、vendor 和 radio 配置了两个槽位（如：<code>system_a</code>，<code>system_b</code>）。

== 常见分区详解 ==

=== '''<code>boot</code> 分区'''： ===
'''此分区包含一个内核映像，使用 <code>mkbootimg</code> 创建。您可以使用虚拟分区直接刷写任意映像，而无需刷写新的 boot 分区。此分区还包含在 Android 13 之前发布的设备中的通用 ramdisk。'''

* kernel：<code>kernel</code> 虚拟分区通过将新内核映像写入旧内核映像来覆盖内核（<code>zImage</code>、<code>zImage-dtb</code>、<code>Image.gz-dtb</code>）。如果提供的开发内核不兼容，则可能需要使用关联的内核模块更新 <code>vendor</code>、<code>system</code> 或 <code>dtb</code> 分区（如果存在）。

* ramdisk：<code>ramdisk</code> 虚拟分区通过将新 ramdisk 映像写入旧 ramdisk 映像来覆盖 ramdisk。

=== '''<code>init_boot</code> 分区'''： ===
'''此分区包含发布时搭载 Android 13 及更高版本的设备的通用 ramdisk。'''

=== '''<code>system</code> 分区'''： ===
'''此分区包含 Android 框架。'''

=== '''<code>system_ext</code> 分区'''： ===
'''由谷歌在 Android 11添加的一个新分区，可以使用 <code>system</code> 资源'''

=== '''<code>recovery</code> 分区'''： ===
'''此分区会存储在 OTA 过程中启动的恢复映像。支持无缝更新的设备可以将恢复映像存储为 <code>boot</code> 或 <code>init_boot</code> 映像中包含的 ramdisk（而不是单独的映像）。'''

'''注意：某些厂商的VAB分区结构设备不包含recovery分区，他们会将recovery分区与boot分区合并，因此当你需要刷入第三方Recovery时需要使用命令：<code>fastboot boot boot.img(具体名称自定)</code>'''

=== '''<code>cache</code> 分区'''： ===
'''此分区会存储临时数据，如果设备使用无缝更新，则此分区是可选的。cache 分区并非必须可从引导加载程序写入，但必须可清空。此分区大小取决于设备类型和 <code>userdata</code> 上的可用空间。通常，50 MB 至 100 MB 就足够了。'''

=== '''<code>misc</code> 分区'''： ===
'''此分区供 recovery 分区使用，大小为 4 KB 或更大。'''

=== '''<code>userdata</code> 分区'''： ===
'''此分区包含用户安装的应用和数据，包括自定义数据。'''

=== '''<code>metadata</code> 分区'''： ===
'''此分区用于在设备使用元数据加密时存储元数据加密密钥。大小为 16 MB 或更大。此分区未经加密，且系统不会对其数据拍摄快照。数据会在设备恢复出厂设置时被清空。此分区的使用受到严格限制。'''

=== '''<code>odm</code> 分区'''： ===
'''此分区包含原始设计制造商 (ODM) 对系统芯片 (SoC) 供应商板级支持包 (BSP) 的自定义设置。利用此类自定义设置，ODM 可以替换或自定义 SoC 组件，并在硬件抽象层 (HAL) 上为板级组件、守护程序和 ODM 特定的功能实现内核模块。此分区是可选的；通常情况下，它用于存储自定义设置，以便设备可以针对多个硬件 SKU 使用单个供应商映像。'''

=== '''<code>odm_dlkm</code> 分区'''： ===
'''此分区专门用于存储 ODM 内核模块。将 ODM 内核模块存储在 <code>odm_dlkm</code> 分区（而不是 <code>odm</code> 分区）中后，无需更新 <code>odm</code> 分区即可更新 ODM 内核模块。'''

=== '''<code>vendor</code> 分区'''： ===
'''此分区包含一些厂商私有的二进制文件以及驱动等内容，用于实现厂商特定功能以及服务，例如图像传感器，音频，显示等，具体作用可以参考于ODM分区，而在各大厂商的系统维护中，如今一加（OnePlus），小米（Xiaomi）等厂商也开始使用ODM分区来存放他们的私有驱动文件，即将 /odm 作为另一个 /vendor 分区处理。'''

=== '''<code>vendor_dlkm</code> 分区'''： ===
'''此分区专门用于存储供应商内核模块。将供应商内核模块存储在 <code>vendor_dlkm</code> 分区（而不是 <code>vendor</code> 分区）中后，无需更新 <code>vendor</code> 分区即可更新内核模块。'''

=== '''<code>radio</code> 分区'''： ===
'''此分区包含无线装置映像，只有包含无线装置且在专用分区中存储无线装置专用软件的设备才需要此分区。'''

=== '''<code>tos</code> 分区'''： ===
'''此分区用于存储 Trusty 操作系统的二进制映像文件，仅在设备包含 Trusty 时使用。Trusty 是 Google 的可信执行环境 (TEE) 操作系统实现，与 Android 并行运行。'''

=== '''<code>pvmfw</code> 分区'''： ===
'''此分区会存储受保护的虚拟机固件 (pvmfw)，即在受保护的虚拟机中运行的第一个代码。如需了解详情，请参阅受保护的虚拟机固件。'''

== 动态分区 ==
搭载 Android 11 及更高版本的设备可以支持动态分区，此类分区属于 Android 的用户空间分区系统，支持在无线下载 (OTA) 更新期间创建和销毁分区以及调整分区大小。使用此分区系统，您可以在无线下载 (OTA) 更新期间创建、销毁分区或者调整分区大小。借助动态分区，供应商无需担心各个分区（例如 <code>system</code>、<code>vendor</code> 和 <code>product</code>）的大小。取而代之的是，设备会分配一个 <code>super</code> 分区，其中的子分区可动态调整大小。各个分区映像不再需要为将来的 OTA 预留空间。相反，<code>super</code> 中剩余的可用空间还可用于所有动态分区。

== 关于 system-as-root ==
在 Android 9 中，非 A/B 设备应采用 system-as-root，以便通过系统专用 OTA 进行更新。

'''注意：如果设备使用的是 A/B 分区架构，则无需做出任何改动。'''

与将 <code>/boot</code> 改为<code>recovery</code>分区的A/B设备不同，非A/B设备必须保留单独的<code>/recovery</code> 分区，因为它们没有后备插槽分区（例如，从 <code>boot_a</code> 切换到 <code>boot_b</code>）。如果在非A/B 设备上移除 <code>/recovery</code>并使其与A/B架构类似，那么在<code>/boot</code>分区更新失败时，恢复模式可能会遭到破坏。因此，对于非A/B设备来说，<code>/recovery</code>分区必须作为单独的分区存在（不同于非A/B设备的<code>/boot</code>），这意味着恢复映像将继续延迟更新（即如同 Android 9 之前的设备中那样）。

对于SAR设备与先前的旧设备，最明显的区别便在于分区的挂载点上，见

'''（非AB设备）'''
[[文件:安卓SAR.png|缩略图|963x963像素|居中]]
== AB分区与无缝更新 ==
Android 有两种更新机制：A/B（无缝）更新和非 A/B 更新，支持无缝更新的系统分区类型有两种，一种是AB分区，一种是VAB分区。

'''安卓系统从7.0开始引入新的OTA升级方式，叫做A/B系统。A/B系统就是设备上有A和B两套可以工作的系统（用户数据只有一份，为两套系统共用），而这样做的好处就是，当OTA进行失败时可以直接切换到另外一个未经OTA的槽位，从而防止设备变砖，而缺点也很明显——两套系统分区意味着其占据多原来一倍的大小。'''

'''而在2020年9月9日，谷歌正式发布了Android11 代号 Android R，而伴随其发布，谷歌也向各大厂商几乎强制安利了一项技术，出厂安卓11的机型必须使用VAB架构 Android Virtual A/B ,而在后续版本Android 12/13 中又增加了 VABC (Virtual A/B with Compression)，增加了压缩功能。'''

'''首先让我们来看一下传统分区与VAB分区的结构'''
[[文件:安卓分区结构对比2.png|缩略图|1029x1029像素|居中]]

'''也就是说，在AB分区的设备中，system_a和system_b等ab分区是真实存在的，他们会占用空间，而在VAB中(以下以默认槽位A为例)，system_a和system_b并非同时存在，因此不会占据大量空间。无缝更新最大的优点在于：几乎无感，安全。'''

OTA 更新可以在系统运行期间进行，不会打断正常的使用。在更新写入完成后，只需要重启一次切换槽位即可完成系统更新。如果 OTA因为刷机失败等原因导致无法启动，将继续启动先前的操作系统。

更新包可以流式传输到 A/B 设备，因此在安装之前不需要先下载更新包。流式更新意味着用户没有必要在 /data 或 /cache 上留出足够的可用空间以存储更新包。

相比之下A-Only设备则没有上述优点，因为只有一套系统分区，如果OTA失败则会直接导致设备无法开机

'''空间占用对比'''

'''：'''
[[文件:谷歌提供的图片.png|缩略图|897x897px|居中]]

== 参考资料： ==
①安卓常见分区：https://source.android.com/docs/core/architecture/partitions?hl=zh-cn#standard-partitions

②安卓A/B系统分区：https://source.android.google.cn/docs/core/ota/ab?hl=zh-cn

③安卓分区布局：https://source.android.google.cn/docs/core/architecture/bootloader/system-as-root?hl=zh-cn#ramdisk

GKI

2024-08-18T09:35:45Z

Mujianwu：/* GKI内核与boot分区的改动 */

=== 介绍 ===
'''通用内核映像 (GKI) 项目'''通过统一核心内核并将 SoC 和板级支持从核心内核移至可加载的供应商模块中，解决了内核碎片化问题。GKI 还为供应商模块提供稳定的内核模块接口 (KMI)，因此模块和内核可以独立进行更新。GKI 内核的一些特性包括：

* GKI 内核基于 ACK 源代码构建而成。
* GKI 内核是每个架构和每个 LTS 版本的单内核二进制文件以及关联的可加载模块（目前只有适用于 <code>android11-5.4</code> 和 <code>android12-5.4</code> 的 arm64）。
* GKI 内核已经过关联 ACK 支持的所有 Android 平台版本的测试。在 GKI 内核版本的生命周期内不会发生功能废弃。
* GKI 内核为给定 LTS 中的驱动程序提供了稳定版 KMI。
* GKI 内核不包含 SoC 专用代码或板级代码。

GKI 是一项复杂的更改，将从 Android 11 平台版本中的 v5.4 内核开始，分几个阶段逐步推出。目前存在两个 GKI 阶段：
** GKI 1.0 是在 Android 11 中面向搭载 5.4 内核的设备推出的。GKI 1.0 适用于所有附带 5.4 内核的设备，乃至发布时搭载 Android 12 或 Android 13 的设备。
** GKI 2.0 是在 Android 12 中面向搭载 5.10 内核的设备推出的，是附带 5.10 或更高版本内核的所有设备的新标准。

=== '''<big>GKI 1.0内核和GKI 2.0内核的区别</big>''' ===
GKI1.0内核与GKI2.0最大的区别就是使 OEM 无需供应商参与即可提供内核安全修复和问题修复 (LTS)，简单来说就是1.0只能算OEM内核的GKI，还是属于aosp内核的下游，例如MTK平台的GKI，<u>高通平台的GKI，也就是人们常说的QGKI（qcom-gki）</u>,而2.0才能直接使用Google所维护aosp内核。

'''''小知识：不少手机厂商随着GKI2.0内核的发展，纷纷都开始直接使用Google编译好的GKI2.0内核，如内核的 suffix 以g开头，那就是Google所编译的GKI内核。例：5.10.101-android12-9-g30979850fc20，g30979850fc20就是 suffix 部分'''''

=== '''<big>GKI内核与boot分区的改动</big>''' ===

* 在 <code>ro.board.first_api_level=29</code>及小于29的boot镜像中(内核版本4.19及以下)，boot镜像包含通用的 ramdisk 和内核。

* 在 <code>ro.board.first_api_level=30</code>的boot镜像中(内核版本5.4)，boot镜像包含通用的 ramdisk 和OEM GKI内核。

* 在 <code>ro.board.first_api_level=31</code> 和<code>ro.board.first_api_level=32</code>的boot镜像中(内核版本5.10)，boot 镜像包含通用的 ramdisk 和 Google GKI 内核。

* 对于发布时搭载 <code>ro.board.first_api_level=33</code>及大于33 的设备(内核版本5.15及以上)，通用 ramdisk 将从 boot 镜像中移除，并放置在单独的 init_boot 镜像中。此更改会使 boot 镜像仅保留 Google GKI 内核。因为 magisk 需要修补RamDisk，来获取root权限，因此在 <code>ro.board.first_api_level=33</code>及大于33 的设备需要提取 init_boot 镜像进行修补。

==== '''如何查看 <code>ro.board.first_api_level=？</code>'''（下列方法二选一） ====

* 使用mt管理终端功能，输入<code>getprop ro.board.first_api_level</code>

* 在开发者调试，开启手机USB调试，使用电脑终端，输入adb shell，授权adb调试权限，输入<code>getprop ro.board.first_api_level</code>

=== '''<big>GKI内核与vendor_boot分区的诞生</big>''' ===
Android 11 引入了通用内核映像 (GKI) 的概念。为了能够使用 GKI 轻松启动任意设备，ro.board.first_api_level=30及30以上设备可以使用启动映像头文件版本 3。在版本 3 中，所有供应商专用信息都已从 boot 分区分离出来并转移到新的 vendor_boot 分区中。

因此，我们需要修改cmdlime来设置Android设备的SELinux为宽容时，应该修改vendor_boot分区中的cmdlime参数，而不是boot或init_boot。

'''''具体参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn#gki-1_0-goals 供应商启动分区]'''''

'''''小知识：4.19版本的Android内核是具有GKI特性的，只不过没有加入KMI功能，只在Google pixel机型上支持，属于内测版本。'''''

=== '''<big>KMI接口</big>''' ===
KMI 全称 Kernel Module Interface，相同 KMI 的内核版本是兼容的这也是 GKI 中“通用”的含义所在；反之，如果 KMI 不同，那么这些内核之间无法互相兼容，刷入与你设备 KMI 不同的内核镜像可能会导致死机。

具体来说，对 GKI 的设备，其内核版本格式应该如下：

<strong>KernelRelease :=</strong>
<table>
<tr>
<td>Version</td>
<td>PatchLevel</td>
<td>SubLevel</td>
<td>AndroidRelease</td>
<td>KmiGeneration</td>
<td>suffix</td>
</tr>
<tr>
<td>w</td>
<td>.x</td>
<td>.y</td>
<td>-zzz</td>
<td>-k</td>
<td>-something</td>
</tr>
<tr>
<td>5</td>
<td>.10</td>
<td>.101</td>
<td>-android12</td>
<td>-9</td>
<td style="border: none; white-space: nowrap;">-g30979850fc20</td>
</tr>
</table>

其中，w.x-zzz-k 为 KMI 版本。例如，一个设备内核版本为5.10.101-android12-9-g30979850fc20，那么它的 KMI 为 5.10-android12-9；理论上刷入其他这个 KMI 的内核也能正常开机。

'''请注意：'''

* '''内核版本中的 SubLevel 不属于 KMI 版本的一部分！'''

* '''内核的 KMI 版本与 Android 版本并不一定相同！'''

* '''新的 Android 设备上可能采取了防回滚机制，它不允许刷入一个安全补丁更旧的内核。比如，如果你的设备内核是 5.10.101-android12-9-g30979850fc20，它的安全补丁为 2023-11；即使你刷入与内核 KMI 一致的内核，如果安全补丁级别比 2023-11要老（例如2023-06），那么很可能会无法开机。因此，在保持 KMI 一致的情况下，优先采用安全补丁级别更新的内核！'''

'''''具体参考：[https://source.android.google.cn/docs/core/architecture/kernel/stable-kmi?hl=zh-cn 保持稳定的内核模块接口 (KMI)] [https://source.android.google.cn/docs/core/architecture/kernel/gki-versioning?hl=zh-cn GKI 版本控制] [https://kernelsu.org/zh_CN/guide/installation.html#kmi KernelSU安装必备知识]'''''

=== '''<big>GKI内核ABI监控</big>''' ===
GKI和ABI的关系主要体现在通过ABI监控工具和符号列表来维护和管理KMI的稳定性，以确保内核的稳定和兼容性。

KMI并非包含内核中的所有符号，甚至并非包含完整的3万多个导出符号。相反，可供模块使用的符号都明确列在一组符号列表文件中，这些文件在内核树的根目录中公开维护。所有符号列表文件中所有符号的并集定义了一组作为稳定版维护的KMI符号。

为了减少需要作为稳定版维护的符号的数量和类型，GKI 内核具有将导出符号限制在模块所需符号范围内的功能。对于外部编译的模块，您需要有一个模块使用的符号列表，以便 GKI 内核可以导出这些符号。例如，模块用于小米机型的符号存储在内核源码的 android 目录下。

'''''具体参考：[https://source.android.google.cn/docs/core/architecture/kernel/abi-monitor?hl=zh-cn Android 内核 ABI 监控]'''''

=== '''<big>[https://source.android.google.cn/docs/setup/build/building-kernels?hl=zh-cn GKI内核编译]</big>''' ===

GKI

2024-08-18T09:24:43Z

Mujianwu：

=== 介绍 ===
'''通用内核映像 (GKI) 项目'''通过统一核心内核并将 SoC 和板级支持从核心内核移至可加载的供应商模块中，解决了内核碎片化问题。GKI 还为供应商模块提供稳定的内核模块接口 (KMI)，因此模块和内核可以独立进行更新。GKI 内核的一些特性包括：

* GKI 内核基于 ACK 源代码构建而成。
* GKI 内核是每个架构和每个 LTS 版本的单内核二进制文件以及关联的可加载模块（目前只有适用于 <code>android11-5.4</code> 和 <code>android12-5.4</code> 的 arm64）。
* GKI 内核已经过关联 ACK 支持的所有 Android 平台版本的测试。在 GKI 内核版本的生命周期内不会发生功能废弃。
* GKI 内核为给定 LTS 中的驱动程序提供了稳定版 KMI。
* GKI 内核不包含 SoC 专用代码或板级代码。

GKI 是一项复杂的更改，将从 Android 11 平台版本中的 v5.4 内核开始，分几个阶段逐步推出。目前存在两个 GKI 阶段：
** GKI 1.0 是在 Android 11 中面向搭载 5.4 内核的设备推出的。GKI 1.0 适用于所有附带 5.4 内核的设备，乃至发布时搭载 Android 12 或 Android 13 的设备。
** GKI 2.0 是在 Android 12 中面向搭载 5.10 内核的设备推出的，是附带 5.10 或更高版本内核的所有设备的新标准。

=== '''<big>GKI 1.0内核和GKI 2.0内核的区别</big>''' ===
GKI1.0内核与GKI2.0最大的区别就是使 OEM 无需供应商参与即可提供内核安全修复和问题修复 (LTS)，简单来说就是1.0只能算OEM内核的GKI，还是属于aosp内核的下游，例如MTK平台的GKI，<u>高通平台的GKI，也就是人们常说的QGKI（qcom-gki）</u>,而2.0才能直接使用Google所维护aosp内核。

'''''小知识：不少手机厂商随着GKI2.0内核的发展，纷纷都开始直接使用Google编译好的GKI2.0内核，如内核的 suffix 以g开头，那就是Google所编译的GKI内核。例：5.10.101-android12-9-g30979850fc20，g30979850fc20就是 suffix 部分'''''

=== '''<big>GKI内核与boot分区的改动</big>''' ===

* 在 <code>ro.board.first_api_level=29</code>及小于29的boot镜像中，boot镜像包含通用的 ramdisk 和内核。

* 在 <code>ro.board.first_api_level=30</code>的boot镜像中，boot镜像包含通用的 ramdisk 和OEM GKI内核。

* 在 <code>ro.board.first_api_level=31</code> 和<code>ro.board.first_api_level=32</code>的boot镜像中，boot 镜像包含通用的 ramdisk 和 Google GKI 内核。

* 对于发布时搭载 <code>ro.board.first_api_level=33</code>及大于33 的设备，通用 ramdisk 将从 boot 镜像中移除，并放置在单独的 init_boot 镜像中。此更改会使 boot 镜像仅保留 Google GKI 内核。因为 magisk 需要修补RamDisk，来获取root权限，因此在 <code>ro.board.first_api_level=33</code>及大于33 的设备需要提取 init_boot 镜像进行修补。

==== '''如何查看 <code>ro.board.first_api_level=？</code>'''（下列方法二选一） ====

* 使用mt管理终端功能，输入<code>getprop ro.board.first_api_level</code>

* 在开发者调试，开启手机USB调试，使用电脑终端，输入adb shell，授权adb调试权限，输入<code>getprop ro.board.first_api_level</code>

=== '''<big>GKI内核与vendor_boot分区的诞生</big>''' ===
Android 11 引入了通用内核映像 (GKI) 的概念。为了能够使用 GKI 轻松启动任意设备，ro.board.first_api_level=30及30以上设备可以使用启动映像头文件版本 3。在版本 3 中，所有供应商专用信息都已从 boot 分区分离出来并转移到新的 vendor_boot 分区中。

因此，我们需要修改cmdlime来设置Android设备的SELinux为宽容时，应该修改vendor_boot分区中的cmdlime参数，而不是boot或init_boot。

'''''具体参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn#gki-1_0-goals 供应商启动分区]'''''

'''''小知识：4.19版本的Android内核是具有GKI特性的，只不过没有加入KMI功能，只在Google pixel机型上支持，属于内测版本。'''''

=== '''<big>KMI接口</big>''' ===
KMI 全称 Kernel Module Interface，相同 KMI 的内核版本是兼容的这也是 GKI 中“通用”的含义所在；反之，如果 KMI 不同，那么这些内核之间无法互相兼容，刷入与你设备 KMI 不同的内核镜像可能会导致死机。

具体来说，对 GKI 的设备，其内核版本格式应该如下：

<strong>KernelRelease :=</strong>
<table>
<tr>
<td>Version</td>
<td>PatchLevel</td>
<td>SubLevel</td>
<td>AndroidRelease</td>
<td>KmiGeneration</td>
<td>suffix</td>
</tr>
<tr>
<td>w</td>
<td>.x</td>
<td>.y</td>
<td>-zzz</td>
<td>-k</td>
<td>-something</td>
</tr>
<tr>
<td>5</td>
<td>.10</td>
<td>.101</td>
<td>-android12</td>
<td>-9</td>
<td style="border: none; white-space: nowrap;">-g30979850fc20</td>
</tr>
</table>

其中，w.x-zzz-k 为 KMI 版本。例如，一个设备内核版本为5.10.101-android12-9-g30979850fc20，那么它的 KMI 为 5.10-android12-9；理论上刷入其他这个 KMI 的内核也能正常开机。

'''请注意：'''

* '''内核版本中的 SubLevel 不属于 KMI 版本的一部分！'''

* '''内核的 KMI 版本与 Android 版本并不一定相同！'''

* '''新的 Android 设备上可能采取了防回滚机制，它不允许刷入一个安全补丁更旧的内核。比如，如果你的设备内核是 5.10.101-android12-9-g30979850fc20，它的安全补丁为 2023-11；即使你刷入与内核 KMI 一致的内核，如果安全补丁级别比 2023-11要老（例如2023-06），那么很可能会无法开机。因此，在保持 KMI 一致的情况下，优先采用安全补丁级别更新的内核！'''

'''''具体参考：[https://source.android.google.cn/docs/core/architecture/kernel/stable-kmi?hl=zh-cn 保持稳定的内核模块接口 (KMI)] [https://source.android.google.cn/docs/core/architecture/kernel/gki-versioning?hl=zh-cn GKI 版本控制] [https://kernelsu.org/zh_CN/guide/installation.html#kmi KernelSU安装必备知识]'''''

=== '''<big>GKI内核ABI监控</big>''' ===
GKI和ABI的关系主要体现在通过ABI监控工具和符号列表来维护和管理KMI的稳定性，以确保内核的稳定和兼容性。

KMI并非包含内核中的所有符号，甚至并非包含完整的3万多个导出符号。相反，可供模块使用的符号都明确列在一组符号列表文件中，这些文件在内核树的根目录中公开维护。所有符号列表文件中所有符号的并集定义了一组作为稳定版维护的KMI符号。

为了减少需要作为稳定版维护的符号的数量和类型，GKI 内核具有将导出符号限制在模块所需符号范围内的功能。对于外部编译的模块，您需要有一个模块使用的符号列表，以便 GKI 内核可以导出这些符号。例如，模块用于小米机型的符号存储在内核源码的 android 目录下。

'''''具体参考：[https://source.android.google.cn/docs/core/architecture/kernel/abi-monitor?hl=zh-cn Android 内核 ABI 监控]'''''

=== '''<big>[https://source.android.google.cn/docs/setup/build/building-kernels?hl=zh-cn GKI内核编译]</big>''' ===

首页

2024-08-18T03:34:21Z

Mujianwu：

== 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:UotanWiki.png|120px]]</span> · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot|ADB 与 Fastboot]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[Recovery 刷机基本操作]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]

== 进阶内容 ==
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Fastbootd|用户空间Fastboot]]
# [[Project Treble|Project Treble（PT）]]
# [[通用系统镜像|通用系统镜像（GSI）]]
# [[GKI|GKI（通用内核映像）]]
# [[Dynamic System Updates|DSU（Dynamic System Updates）]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[格式化分区]]
# [[修改分区]]
# [[QCN]]

== 系统修改 ==
# [[ADB命令|ADB 命令]]
# [[HDC命令|HDC 命令]]
# [[Magisk模块|Magisk 模块]]
# [[LsPosed 模块|LSPosed 模块]]
# [[KSU 模块]]
# [[修改方案合集]]

== Mindows工具箱 ==
# [[为手机刷入Windows|为手机刷入 Windows]]
# [[更新驱动程序]]
# [[重新安装Windows|重新安装 Windows]]
# [[一些常见问题及其解决方案]]

== 高级内容 ==
# [[AOSP]]
# [[Android 分区详解]]
# [[SELinux]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[高通端口合集]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
# [[Android内核编译入门]]
# [[为新设备编写Recovery device tree]]
# [[为新设备编写类原生device tree]]

== 知名类原生ROM ==
# [[AfterLife]]
# [[AlphaDroid]]
# [[AOSPA]]
# [[ArrowOS]]
# [[crDroid]]
# [[dotOS]]
# [[DroidX]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[KaleidoscopeOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingOS]]
注：以上排序不分先后

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
注：以上排序不分先后

== 知名玩机开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]
注：以上排序不分先后

== 更多词条 ==
# [[设备代号收录集合]]
# [[Android 版本合集]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

首页

2024-08-18T01:39:10Z

Mujianwu：

== 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:UotanWiki.png|120px]]</span> · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot|ADB 与 Fastboot]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[Recovery 刷机基本操作]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]

== 进阶内容 ==
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Fastbootd|用户空间Fastboot]]
# [[Project Treble|Project Treble（PT）]]
# [[通用系统镜像|通用系统镜像（GSI）]]
# [[GKI|GKI（通用内核映像）]]
# [[Dynamic System Updates|DSU（Dynamic System Updates）]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[格式化分区]]
# [[修改分区]]
# [[QCN]]

== 系统修改 ==
# [[ADB命令|ADB 命令]]
# [[HDC命令|HDC 命令]]
# [[Magisk模块|Magisk 模块]]
# [[LsPosed 模块|LSPosed 模块]]
# [[KSU 模块]]
# [[修改方案合集]]

== Mindows工具箱 ==
# [[为手机刷入Windows|为手机刷入 Windows]]
# [[更新驱动程序]]
# [[重新安装Windows|重新安装 Windows]]
# [[一些常见问题及其解决方案]]

== 高级内容 ==
# [[AOSP]]
# [[Android 分区详解]]
# [[SELinux]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[高通端口合集]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
# [[Android内核编译入门]]
# [[为新设备编写Recovery device tree]]
# [[为新设备编写类原生device tree]]

== 知名类原生ROM ==
# [[AfterLife]]
# [[AlphaDroid]]
# [[AOSPA]]
# [[ArrowOS]]
# [[crDroid]]
# [[dotOS]]
# [[DroidX]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[KaleidoscopeOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingOS]]
注：以上排名不分先后

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
注：以上排名不分先后

== 知名玩机开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]
注：以上排名不分先后

== 更多词条 ==
# [[设备代号收录集合]]
# [[Android 版本合集]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

CrDroid

2024-08-18T01:37:15Z

Mujianwu：

crDroid是一个老牌的Android类原生项目，基于LineageOS，官方包含Android5.0-Android14.0的Android版本，并且仍在持续更新

自定义超多，同样具有Vanilla和Gapps两种包供选择

官网: [https://crdroid.net/ crDroid]

Github: [https://github.com/crdroidandroid crDroid]

Sourceforge: [https://sourceforge.net/projects/crdroid/ crDroid]

下面附上crDroid10.2在evergo上的截图:

[[文件:CrDroid1.png|无框|506x506px]][[文件:CrDroid2.png|无框|506x506px]][[文件:CrDroid3.png|无框|506x506px]][[文件:CrDroid4.png|无框|506x506px]]

AlphaDroid

2024-08-18T01:32:16Z

Mujianwu：

<gallery>
文件:Alphadroid.png|Logo
</gallery>AlphaDroid是一个基于类原生crDroid的Android类原生项目，目前有Android13和Android14

目前持续更新中，有Vanilla和Gapps两个版本供选择

AlphaDroid较为省电，自定义程度高，具有大量的自定义选项

Github: [https://github.com/AlphaDroid-Project/ AlphaDroid]

Sourceforge: [https://sourceforge.net/projects/alphadroid-project Sourceforge]

（这里附上几张AlphaDroid 13在vince上的截图）

[[文件:AlphaDroid1.jpg|无框|506x506px]][[文件:AlphaDroid2.jpg|无框|506x506px]][[文件:AlphaDroid3.jpg|无框|506x506像素]]

AlphaDroid

2024-08-18T01:31:17Z

Mujianwu：

[[文件:AlphaDroid3.jpg|缩略图|501x501像素]]<gallery>
文件:Alphadroid.png|Logo
</gallery>AlphaDroid是一个基于类原生crDroid的Android类原生项目，目前有Android13和Android14

目前持续更新中，有Vanilla和Gapps两个版本供选择

AlphaDroid较为省电，自定义程度高，具有大量的自定义选项

Github: [https://github.com/AlphaDroid-Project/ AlphaDroid]

Sourceforge: [https://sourceforge.net/projects/alphadroid-project Sourceforge]

（这里附上几张AlphaDroid 13在vince上的截图）

[[文件:AlphaDroid1.jpg|无框|437x437像素]][[文件:AlphaDroid2.jpg|无框|438x438像素]]

ExTHmUI

2024-08-17T15:09:19Z

Mujianwu：

Exthm UI 是一款有着东方 Project元素的Android类原生项目，添加了一些易于国人使用的小功能。

[[文件:Logo.png|缩略图]]

该项目目前提供Android13版本。

PS:Android14版本又又又又爆了=⁠_⁠=

Github: https://github.com/exTHmUI

首页

2024-08-17T15:03:44Z

Mujianwu：

== 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:UotanWiki.png|120px]]</span> · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot|ADB 与 Fastboot]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[Recovery 刷机基本操作]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]

== 进阶内容 ==
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Fastbootd|用户空间Fastboot]]
# [[Project Treble|Project Treble（PT）]]
# [[通用系统镜像|通用系统镜像（GSI）]]
# [[GKI|GKI（通用内核映像）]]
# [[Dynamic System Updates|DSU（Dynamic System Updates）]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[格式化分区]]
# [[修改分区]]
# [[QCN]]

== 系统修改 ==
# [[ADB命令|ADB 命令]]
# [[HDC命令|HDC 命令]]
# [[Magisk模块|Magisk 模块]]
# [[LsPosed 模块|LSPosed 模块]]
# [[KSU 模块]]
# [[修改方案合集]]

== Mindows工具箱 ==
# [[为手机刷入Windows|为手机刷入 Windows]]
# [[更新驱动程序]]
# [[重新安装Windows|重新安装 Windows]]
# [[一些常见问题及其解决方案]]

== 高级内容 ==
# [[AOSP]]
# [[Android 分区详解]]
# [[SELinux]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[高通端口合集]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
# [[Android内核编译入门]]
# [[为新设备编写Recovery device tree]]
# [[为新设备编写类原生device tree]]

== 知名类原生ROM ==
# [[AfterLife]]
# [[AlphaDroid]]
# [[AOSPA]]
# [[ArrowOS]]
# [[AwakenOS]]
# [[CipherOS]]
# [[crDroid]]
# [[dotOS]]
# [[DroidX]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[KaleidoscopeOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingOS]]
# [[SuperiorOS]]
# [[SyberiaOS]]
注：以上排名不分先后

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
注：以上排名不分先后

== 知名玩机开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]
注：以上排名不分先后

== 更多词条 ==
# [[设备代号收录集合]]
# [[Android 版本合集]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

修改分区

2024-08-17T13:32:21Z

Mujianwu：

== 方法一：使用 Parted 工具 ==

=== 简介 ===
Parted 是一个开源的命令行工具，主要用于管理磁盘分区，广泛应用于 Linux 和其他类 Unix 操作系统中。它提供了丰富的功能，支持多种分区表类型，并能够处理多种文件系统格式。Parted 是管理大容量磁盘、处理复杂分区表（如 GPT）的理想选择。

=== 主要功能 ===
Parted 提供了一系列强大的磁盘管理功能，包括但不限于：

•'''创建、删除和调整分区'''：允许用户创建新分区、删除现有分区，以及在不丢失数据的情况下调整分区的大小。

•'''支持多种分区表类型'''：兼容传统的 MBR（Master Boot Record）和较新的 GPT（GUID Partition Table）分区表，满足不同磁盘布局的需求。

•'''格式化分区'''：可以将分区格式化为多种文件系统类型，如 ext4、FAT32、NTFS 等。

•'''检查和修复分区'''：具备检测分区错误的能力，并尝试修复可能出现的问题，确保磁盘的健康状态。

•'''查看磁盘信息'''：能够显示磁盘的分区布局及详细信息，帮助用户快速了解磁盘的当前配置。

=== 常用命令 ===
在 Parted 交互式终端中，可以使用以下常用命令：

•'''print'''：显示磁盘的分区表信息。

•'''mkpart'''：创建新分区。

•'''rm'''：删除指定的分区。

•'''resizepart'''：调整指定分区的大小。

•'''quit'''：退出 Parted 终端。

=== 使用方法 ===
使用'''<code>Parted</code>'''对分区表进行操作，你得先找到这个分区表的'''绝对目录'''

然后以如下的格式用Parted打开这个分区表
parted <file_path>

例如你要对Android设备中的sda分区表进行Parted操作，那么你就应该输入如下的指令
parted /dev/block/sda
值得注意的是：在<code>'''Recovery'''</code>中使用'''<code>Parted</code>'''的时候需要将其放在<code>'''system/bin'''</code>或者是<code>'''/bin'''</code>中，并且确保其权限为'''<code>0777</code>'''或者是'''<code>0755</code>'''

我们<mark>不推荐</mark>推荐你在<mark>系统状态下</mark>使用parted对分区进行操作，特别是<mark>删除分区</mark>的时候，避免删除System分区或者是其他重要系统分区导致手机无法开机只能进行9008刷机处理。

当你利用parted进入sda的时候你会看到如下
GNU Parted 3.2 <code>'''--parted的版本'''</code>
Using /dev/block/sda <code>'''--这是你进入的分区表的路径'''</code>
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) <code>'''--parted的命令行'''</code>
我们现在来举一个例子让你可以更好的理解上述的命令是怎么使用的

首先输入<code>print或者是p</code>如下是返回结果
<code>'''(parted)'''</code> p
Model: SAMSUNG KLUEG8UHDC-B0E1 (scsi)
Disk /dev/block/sda: 253GB
Sector size (logical/physical): 4096B/4096B
Partition Table: gpt
Disk Flags:

Number Start End Size File system Name Flags
1 24.6kB 32.8kB 8192B switch
2 32.8kB 65.5kB 32.8kB ssd
3 65.5kB 98.3kB 32.8kB dbg
4 98.3kB 131kB 32.8kB bk01
5 131kB 262kB 131kB bk02
6 262kB 524kB 262kB bk03
7 524kB 1049kB 524kB bk04
8 1049kB 1573kB 524kB keystore
9 1573kB 2097kB 524kB frp
10 2097kB 4194kB 2097kB countrycode
11 4194kB 8389kB 4194kB misc
12 8389kB 16.8MB 8389kB bk06
13 16.8MB 25.2MB 8389kB logfs
14 25.2MB 33.6MB 8389kB ffu
15 33.6MB 50.3MB 16.8MB oops
16 50.3MB 67.1MB 16.8MB devinfo
17 67.1MB 83.9MB 16.8MB ext4 metadata
18 83.9MB 101MB 16.8MB bk08
19 101MB 134MB 33.6MB splash
20 134MB 168MB 33.6MB bk09
21 168MB 235MB 67.1MB ext4 persist
22 235MB 302MB 67.1MB ext4 persistbak
23 302MB 336MB 33.6MB mtdblk
24 336MB 403MB 67.1MB logdump
25 403MB 503MB 101MB minidump
26 503MB 713MB 210MB rawdump
28 2861MB 12.0GB 9127MB super
29 12.0GB 12.0GB 131kB vbmeta_system_a
30 12.0GB 12.0GB 131kB vbmeta_system_b
31 12.0GB 12.0GB 33.3MB bk010
32 12.0GB 12.2GB 134MB ext4 rescue
33 12.2GB 253GB 241GB userdata
Ok你会看到如下这几个，我会一一介绍他们
Number Start End Size File system Name
分区ID 开始头结束头总大小文件系统分区名字

其中Size的大小计算是：结束头-开始头
现在介绍一下'''常用命令'''的格式（Args）

<code>rm <Number></code>

<code>mkpart <Name> <File system> <Start> <End></code>

<code>resizepart <Number> <Size></code>

假设你现在要对super进行删除并且扩容那么你应该做如下
<code>'''(parted)'''</code> rm 28(Super分区的Number)
这里省略了日志输出，如果有提示是带有ignore的你输入ignore就行了

<code>'''(parted)'''</code> mkpart super <File System我不知道待补充> 2861MB 114514MB(MB要大写如果是GB那也要)
PS：这里补充一个东西，分区表是出厂就设置好的所以你想扩容某些分区你就得牺牲userdata的小大，如果你要扩容super你就1g那就必须删除1g的userdata，方法和这一样这里就不过多赘述了，切记删除userdata后需要记得他的Start值然后把它的Start值给扩容的super用，super的End值给userdata的Start值使用，userdata的End值填原本的。
<code>'''(parted)'''</code>quit（退出）

=== 总结 ===
读完了本文你学会了Parted的基本使用方法，但是还是要知道对分区操作是极度危险的如果真的不是很会真的别轻易尝试

==== 文献参考： ====
https://cn.linux-console.net/?p=29398

https://www.gnu.org/software/parted/

==== Parted下载： ====
https://ftp.gnu.org/gnu/parted/

== 更多方法如 sgdisk 等工具本篇暂不做解释 ==

Super Empty

2024-08-17T13:27:34Z

Mujianwu：

== 简介 ==
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。

对原生动态分区来说

它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。

对改造动态分区来说

它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。

== 使用方法 ==
=== 原生动态分区设备 ===

==== 方法一：使用命令刷入 ====
fastboot wipe-super super_empty.img的路径

==== 方法二：使用柚坛工具箱刷入 ====
在柚坛工具箱的格式化&提取页面中的SuperEmpty部分选择对应的SuperEmpty文件，随后点击刷入文件即可。
[[文件:备份与提取.png|居中|缩略图|617x617像素]]

=== 改造动态分区设备 ===
==== 类原生 ====
1.刷入维护者提供的recovery.img，在rec和boot合并的机器上也可以是boot.img

2.进入fastbootd模式

可使用如下命令：
fastboot reboot fastboot
3.准备最新版本的adb-fastboot工具包和维护者提供的super_empty.img

4.打开命令行进入工具包目录，使用上一节原生动态分区的方法执行命令。如果设备是ab分区，则您应该切换到另外一个槽位再执行一次。

5.重新进入recovery，格式化data分区。

6.连接电脑，使用[[ADB SideLoad|adb sideload]]刷入。

==== GSI ====
改造动态分区之后，使用 AOSP Recovery 或 TWRP 的Fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。

== 对开发者的一些帮助 ==
[https://github.com/uwu-gl/device_oneplus_sdm845-common/commit/2e2b515df62421024695c08240074df678dbb4c9 改造动态分区的示例commit]

如果分区大小还是不够，您可以考虑切换到erofs或squashfs等等压缩文件系统。必须在内核中有文件系统相关支持且fstab中正确指定挂载参数。

对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否100%匹配。

Super Empty

2024-08-17T13:27:23Z

Mujianwu：

= Super empty =

== 简介 ==
它是任何动态分区设备在系统构建时可选的产物。它一个定义了动态分区信息的空镜像。它的主要作用是为设备提供一个初始的分区表。

对原生动态分区来说

它自身包含了对逻辑分区的映射信息及逻辑分区大小。可以用于清除或更新super分区，比如后期重新分区逻辑分区大小。

对改造动态分区来说

它定义了维护者定义的设备自身分区和分区大小，将它们合并成一个大的“super”供刷入第三方ROM使用，甚至可以让老旧设备运行DSU。并且针对这类设备它的意义远不止类原生，对PT(Project Treble)也有帮助，有经验的维护者可以通过改造动态分区的方式让用户无需扩容即可体验深度定制UI。

== 使用方法 ==
=== 原生动态分区设备 ===

==== 方法一：使用命令刷入 ====
fastboot wipe-super super_empty.img的路径

==== 方法二：使用柚坛工具箱刷入 ====
在柚坛工具箱的格式化&提取页面中的SuperEmpty部分选择对应的SuperEmpty文件，随后点击刷入文件即可。
[[文件:备份与提取.png|居中|缩略图|617x617像素]]

=== 改造动态分区设备 ===
==== 类原生 ====
1.刷入维护者提供的recovery.img，在rec和boot合并的机器上也可以是boot.img

2.进入fastbootd模式

可使用如下命令：
fastboot reboot fastboot
3.准备最新版本的adb-fastboot工具包和维护者提供的super_empty.img

4.打开命令行进入工具包目录，使用上一节原生动态分区的方法执行命令。如果设备是ab分区，则您应该切换到另外一个槽位再执行一次。

5.重新进入recovery，格式化data分区。

6.连接电脑，使用[[ADB SideLoad|adb sideload]]刷入。

==== GSI ====
改造动态分区之后，使用 AOSP Recovery 或 TWRP 的Fastbootd，刷入system分区，即可不需扩容也能使用上超过system物理空间大小的镜像。

== 对开发者的一些帮助 ==
[https://github.com/uwu-gl/device_oneplus_sdm845-common/commit/2e2b515df62421024695c08240074df678dbb4c9 改造动态分区的示例commit]

如果分区大小还是不够，您可以考虑切换到erofs或squashfs等等压缩文件系统。必须在内核中有文件系统相关支持且fstab中正确指定挂载参数。

对于在Mac上正常刷写super_empty在win或linux下不能正常刷写的情况，请检查device tree内定义的数值是否100%匹配。

格式化分区

2024-08-17T13:21:03Z

Mujianwu：创建页面，内容为“一般情况下使用TWRP进行格式化即可具体参见 [https://wiki.uotan.cn/index.php?title=Recovery_%E5%88%B7%E6%9C%BA%E5%9F%BA%E6%9C%AC%E6%93%8D%E4%BD%9C#%E9%AB%98%E7%BA%A7%E6%B8%85%E9%99%A4 TWRP高级清除] 另外，也可在Fastboot中使用Fastboot命令进行格式化具体参见 [https://wiki.uotan.cn/index.php?title=Fastboot_%E5%91%BD%E4%BB%A4#%E6%93%A6%E9%99%A4%E7%9B%B8%E5%85%B3%EF%BC%88erase%EF%BC%89 Fastboot擦除数据] 在第三方Recovery…”

一般情况下使用TWRP进行格式化即可具体参见 [https://wiki.uotan.cn/index.php?title=Recovery_%E5%88%B7%E6%9C%BA%E5%9F%BA%E6%9C%AC%E6%93%8D%E4%BD%9C#%E9%AB%98%E7%BA%A7%E6%B8%85%E9%99%A4 TWRP高级清除]

另外，也可在Fastboot中使用Fastboot命令进行格式化具体参见 [https://wiki.uotan.cn/index.php?title=Fastboot_%E5%91%BD%E4%BB%A4#%E6%93%A6%E9%99%A4%E7%9B%B8%E5%85%B3%EF%BC%88erase%EF%BC%89 Fastboot擦除数据]

在第三方Recovery中也可以使用诸如 mke2fs、mkfs.f2fs、mkfs.fat、mkexfatfs、mkntfs 等工具进行格式化，但由于其用法太多本章暂时不做解释。

=== 使用柚坛工具箱进行格式化分区 ===
在柚坛工具箱的格式化&提取页面中的格式化部分填写对于分区，并选择像要格式化为的文件系统（选择文件系统仅支持ADB格式化），随后点击ADB格式化或Fastboot格式化即可完成。
[[文件:备份与提取.png|居中|缩略图|666x666像素]]
格式化部分的格式化Data分区和 TWRP格式化Data 为用于 AOSP Recovery 和 TWRP Recovery 的快捷清楚全部数据的选项，不涉及其他工具的使用。