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

Android 版本合集

2024-12-02T14:02:06Z

SakuraKyuo：更新安卓15正式发布时间以及安卓16版本号

说明：Android 10开始，Google不再使用甜品代号来公开命名Android版本。本wiki如有记录则为其内部代号。

{| class="wikitable"
|+
!版本
!API版本
!代号
!发布时间
|-
|Android 1.0
|1
|无
|2008/09
|-
|Android 1.1
|2
|Base
|2009/02
|-
|Android 1.5
|3, NDK 1
|Cupcake
|2009/04
|-
|Android 1.6
|4, NDK 2
|Donut
|2009/09
|-
|Android 2.0
|5
|Eclair
|2009/10
|-
|Android 2.0.1
|6
|Eclair
|2009/12
|-
|Android 2.1
|7, NDK 3
|Eclair
|2010/01
|-
|Android 2.2.x
|8, NDK 4
|Froyo
|2010/05
|-
|Android 2.3-2.3.2
|9, NDK 5
|Gingerbread
|2011/01
|-
|Android 2.3.3-2.3.7
|10
|Gingerbread
|2011/09
|-
|Android 3.0
|11
|Honeycomb
|2011/02
|-
|Android 3.1
|12, NDK 6
|Honeycomb
|2011/05
|-
|Android 3.2.x
|13
|Honeycomb
|2011/07
|-
|Android 4.0.1-4.0.2
|14, NDK 7
|IceCreamSandwich
|2011/10
|-
|Android 4.0.3-4.0.4
|15, NDK 8
|IceCreamSandwich
|2012/02
|-
|Android 4.1(.1)
|16
|JellyBean
|2012/06
|-
|Android 4.2-4.2.2
|17
|JellyBean
|2012/11
|-
|Android 4.3
|18
|JellyBean
|2013/07
|-
|Android 4.4
|19-20
|KitKat
|2013/10
|-
|Android 5.0-5.1
|21-22
|Lollipop
|2014/11
|-
|Android 6.0
|23
|Marshmallow
|2015/10
|-
|Android 7.0-7.1
|24-25
|Nougat
|2016/08
|-
|Android 8.0-8.1
|26-27
|Oreo
|2017/08
|-
|Android 9.0
|28
|Pie
|2018/08
|-
|Android 10
|29
|QuinceTart
|2019/09
|-
|Android 11
|30
|RedVelvetCake
|2020/09
|-
|Android 12(L)
|31-32
|SnowCone
|2021/10
|-
|Android 13
|33
|Tiramisu
|2022/08
|-
|Android 14
|34
|UpsideDownCake
|2023/08
|-
|Android 15
|35
|VanillaIceCream
|2024/10
|-
|Android 16
|36
|Baklava
|暂未发布正式版
|}

YAAP

2024-08-28T11:15:21Z

SakuraKyuo：YAAP

[[文件:Yaap-logo.jpg|缩略图]]
Yet Another AOSP Project是基于AOSP的Android类原生项目，旨在与 AOSP 保持密切联系。

官网: [https://robotwombat.github.io/YAAP-website/ YAAP]

Github组织: [https://github.com/yaap YAAP]

文件:Yaap-logo.jpg

2024-08-28T11:15:05Z

SakuraKyuo：

yaap logo

首页

2024-08-28T11:12:04Z

SakuraKyuo：Add YAAP

== 欢迎来到 <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]]
# [[如何从源码构建 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)]]

Project Treble

2024-08-06T06:09:23Z

SakuraKyuo：首次创建

Project Treble 是谷歌在Android Oreo（8.0）版本中引入的重要改进项目。它旨在改善Android设备的软件更新流程，使得设备制造商更快速、更容易地发布新的Android版本和安全补丁。

=== Project Treble 的工作原理 ===
在引入Project Treble之前，Android系统的架构使得设备制造商在发布新的Android版本时需要进行大量的系统集成和调试工作，这使得更新过程通常缓慢且耗费资源。Project Treble通过引入新的体系结构层次，将操作系统框架（Android OS framework）与设备特定的硬件抽象层（HAL）分离开来。这种分层设计使得设备制造商可以更独立地更新Android框架部分，而无需修改底层硬件驱动程序。

=== Project Treble 的确认支持方法 ===
要确认设备是否支持Project Treble，可以通过以下方式进行：

* '''1. 检查设备发布时的Android版本：''' 设备必须运行Android Oreo（8.0）或更高版本，因为Project Treble从Android Oreo开始实施。
* '''2. 使用ADB命令行确认：''' 可以通过Android调试桥（ADB）命令行检查设备的Treble支持情况。运行以下命令：
adb shell getprop ro.treble.enabled

如果返回值为 <code>true</code>，则表示设备支持Project Treble。
* '''3. 使用Treble Check确认：'''从 [https://github.com/kevintresuelo/treble GitHub]下载 Treble Check 并打开查看 Project Treble 一栏是否为 '''支持'''

=== Project Treble 的优势 ===

* '''加快软件更新速度：''' 设备制造商可以更快地适配和发布新的Android版本和安全补丁，改善用户体验并增强设备的安全性。
* '''降低开发成本和复杂度：''' Treble的引入使得设备制造商能够更容易地进行系统更新，减少了为适配新版本Android而进行的繁琐工作和开发成本。
* '''增强设备的生命周期：''' 更新更快速和有效的Android系统使得老旧设备仍能享受到新功能和改进，延长了设备的使用寿命和市场竞争力。

Project Treble作为Android生态系统的重要改进，显著提升了Android设备的软件更新和维护效率，为用户带来更好的使用体验。

AOSP

2024-08-06T05:56:27Z

SakuraKyuo：AOSP补全

Android Open Source Project（AOSP）是由Google主导开发的开放源代码项目，旨在提供一个开放和可定制的移动操作系统平台。AOSP为开发者提供了Android操作系统的完整源代码，使他们可以基于这些代码构建、定制和优化适合各种设备的Android系统。

=== AOSP的特点和功能： ===

* '''开放源代码：''' AOSP的核心特性是其开放的源代码许可证，使开发者可以自由地查看、修改和分发Android操作系统的代码。
* '''定制性和灵活性：''' 开发者可以根据需要自定义和优化AOSP代码，以创建定制化的Android系统，适配不同的硬件和应用场景。
* '''社区驱动：''' AOSP的开发不仅限于Google，全球的开发者和贡献者通过社区合作和反馈不断改进和完善系统。

=== 基于AOSP发布的系统： ===

# '''LineageOS：''' 基于AOSP的LineageOS是一个流行的开源Android分支，提供广泛的设备支持和定制选项，同时注重安全和性能。
# '''Pixel Experience：''' Pixel Experience旨在为非Google设备提供类似Google Pixel手机的纯净Android体验，包含Google服务和应用。

Dynamic System Updates

2024-08-06T05:51:47Z

SakuraKyuo：

Dynamic System Updates（DSU）是谷歌在Android 10中引入的一项创新功能。它允许用户在设备上加载和运行新的Android系统映像，作为当前操作系统的替代，而无需擦除现有系统。这意味着用户可以轻松地尝试下一个Android版本或测试不同的Android体验，而不会破坏他们现有系统。

=== DSU的功能和优势： ===

* '''无需擦除现有系统：''' DSU允许用户加载新的Android系统映像，而不会擦除当前的操作系统和数据。这种无缝切换的能力使得用户可以灵活地管理和测试不同版本的Android系统。
* '''灵活性和便捷性：''' 用户可以根据需要随时启用或禁用DSU功能。这为开发者、测试人员和普通用户提供了便利，他们可以在不影响现有配置的情况下，尝试和评估新的Android版本或功能。
* '''安全性保障：''' DSU依赖于device-mapper-verity（dm-verity）内核功能来验证新加载的Android系统映像。这种安全性措施确保系统映像的完整性和安全性，防止恶意软件或损坏的系统映像被加载和运行。

=== DSU的实现要求： ===

* 为了启用DSU功能，系统必须配置以下内核选项：

CONFIG_DM_VERITY=y
CONFIG_DM_VERITY_FEC=y

* Google为了存储与已安装DSU镜像相关的数据需要使用 <code>metadata</code> 分区，这要求机器必须为动态分区(Dynamic Partition)

=== DSU 流程 ===
本部分介绍如何执行多个 DSU 配置流程。

==== 生成新的密钥对 ====
使用 <code>openssl</code> 命令生成 <code>.pem</code> 格式的 RSA 私钥/公钥对（例如，大小为 2048 位）：
openssl genrsa -out oem_cert_pri.pem 2048
openssl rsa -in oem_cert_pri.pem -pubout -out oem_cert_pub.pem
私钥可能无法访问，并且只保存在[[wikipedia:Hardware_security_module|硬件安全模块 (HSM)]] 中。在这种情况下，密钥生成后可能会提供 x509 公钥证书。如需了解如何通过 x509 证书生成 AVB 公钥，请参阅将[[Dynamic System Updates#将配对公钥添加到 ramdisk|配对公钥添加到 ramdisk]] 部分。

如需将 x509 证书转换为 PEM 格式，请运行以下命令：

<code>openssl x509 -pubkey -noout -in oem_cert_pub.x509.pem > oem_cert_pub.pem</code>

==== 将配对公钥添加到 ramdisk ====
<code>oem_cert.avbpubkey</code> 必须放在 <code>/avb/*.avbpubkey</code> 下，以验证已签名的 DSU 软件包。首先，将 PEM 格式的公钥转换为 AVB 公钥格式：

<code>avbtool extract_public_key --key oem_cert_pub.pem --output oem_cert.avbpubkey</code>

然后，按照以下步骤在第一阶段 ramdisk 中添加公钥。

* 1. 添加一个预构建模块以复制 <code>avbpubkey</code>。例如，使用如下内容可添加 <code>device/<company>/<board>/oem_cert.avbpubkey</code> 和 <code>device/<company>/<board>/avb/Android.mk</code>：

include $(CLEAR_VARS)

LOCAL_MODULE := oem_cert.avbpubkey
LOCAL_MODULE_CLASS := ETC
LOCAL_SRC_FILES := $(LOCAL_MODULE)
ifeq ($(BOARD_USES_RECOVERY_AS_BOOT),true)
LOCAL_MODULE_PATH := $(TARGET_RECOVERY_ROOT_OUT)/first_stage_ramdisk/avb
else
LOCAL_MODULE_PATH := $(TARGET_RAMDISK_OUT)/avb
endif

include $(BUILD_PREBUILT)

* 2. 让 droidcore 目标依赖于添加的 <code>oem_cert.avbpubkey</code>：

<code>droidcore: oem_cert.avbpubkey</code>

==== 在 JSON 描述符中生成 AVB 公钥属性 ====
<code>oem_cert.avbpubkey</code> 采用 AVB 公钥二进制格式。在将它放入 JSON 描述符之前，使用 SHA-1 使其可读。
sha1sum oem_cert.avbpubkey | cut -f1 -d ' '
3e62f2be9d9d813ef5........866ac72a51fd20
以下将是 JSON 描述符的 <code>pubkey</code> 属性的内容。
"images":[
{
...
"pubkey":"3e62f2be9d9d813ef5........866ac72a51fd20",
...
},

==== 对 DSU 软件包进行签名 ====
使用下列方法之一对 DSU 软件包进行签名：

* '''方法 1：重复使用通过原始 AVB 签名流程创建的工件创建 DSU 软件包。一种替代方式是从发布软件包中提取已签名的映像，并使用提取的映像直接创建 ZIP 文件。'''
* '''方法 2：在私钥可用时使用以下命令对 DSU 分区进行签名。DSU 软件包（ZIP 文件）中的每个 <code>img</code> 均会单独签名：'''
key_len=$(openssl rsa -in oem_cert_pri.pem -text | grep Private-Key | sed -e 's/.*($.*$ bit.*/\1/')
for partition in system product; do
avbtool add_hashtree_footer \
--image ${OUT}/${partition}.img \
--partition_name ${partition} \
--algorithm SHA256_RSA${key_len} \
--key oem_cert_pri.pem
done
如需详细了解如何使用 <code>avbtool</code> 添加 <code>add_hashtree_footer</code>，请参阅使用 [https://android.googlesource.com/platform/external/avb/#using-avbtool avbtool]。

==== 在本地验证 DSU 软件包 ====
建议您使用以下命令对照配对公钥验证所有本地映像：
for partition in system product; do
avbtool verify_image --image ${OUT}/${partition}.img --key oem_cert_pub.pem
done
预期的输出如下所示：
Verifying image dsu/system.img using key at oem_cert_pub.pem
vbmeta: Successfully verified footer and SHA256_RSA2048 vbmeta struct in dsu/system.img
: Successfully verified sha1 hashtree of dsu/system.img for image of 898494464 bytes

Verifying image dsu/product.img using key at oem_cert_pub.pem
vbmeta: Successfully verified footer and SHA256_RSA2048 vbmeta struct in dsu/product.img
: Successfully verified sha1 hashtree of dsu/product.img for image of 905830400 bytes

==== 创建 DSU 软件包 ====
以下示例将展示如何创建一个包含 <code>system.img</code> 和 <code>product.img</code> 的 DSU 软件包：
dsu.zip {
- system.img
- product.img
}
在两个映像均已签名后，使用以下命令创建 ZIP 文件：
mkdir -p dsu
cp ${OUT}/system.img dsu
cp ${OUT}/product.img dsu
cd dsu && zip ../dsu.zip *.img && cd -

==== 自定义一键式 DSU ====
默认情况下，DSU 加载器指向 GSI 映像的元数据，即 <code><nowiki>https://...google.com/.../gsi-src.json</nowiki></code>。

OEM 可以通过定义指向其 JSON 描述符的 <code>persist.sys.fflag.override.settings_dynamic_system.list</code> 属性来覆盖该列表。例如，OEM 可能会提供包含 GSI 和 OEM 专有映像的 JSON 元数据，如下所示：
{
"include": ["<nowiki>https://dl.google.com/.../gsi-src.JSON</nowiki>"]
"images":[
{
"name":"OEM image",
"os_version":"10",
"cpu_abi": "arm64-v8a",
"details":"...",
"vndk":[
27,
28,
29
],
"spl":"...",
"pubkey":"",
"uri":"<nowiki>https://.../....zip</nowiki>"
},
}
OEM 可以链接已发布的 DSU 元数据，如图所示。
[[文件:Dsu-metadata-chaining.png|缩略图]]

Dynamic System Updates

2024-08-06T05:51:16Z

SakuraKyuo：首次创建

Dynamic System Updates（DSU）是谷歌在Android 10中引入的一项创新功能。它允许用户在设备上加载和运行新的Android系统映像，作为当前操作系统的替代，而无需擦除现有系统。这意味着用户可以轻松地尝试下一个Android版本或测试不同的Android体验，而不会破坏他们现有系统。

=== DSU的功能和优势： ===

* '''无需擦除现有系统：''' DSU允许用户加载新的Android系统映像，而不会擦除当前的操作系统和数据。这种无缝切换的能力使得用户可以灵活地管理和测试不同版本的Android系统。
* '''灵活性和便捷性：''' 用户可以根据需要随时启用或禁用DSU功能。这为开发者、测试人员和普通用户提供了便利，他们可以在不影响现有配置的情况下，尝试和评估新的Android版本或功能。
* '''安全性保障：''' DSU依赖于device-mapper-verity（dm-verity）内核功能来验证新加载的Android系统映像。这种安全性措施确保系统映像的完整性和安全性，防止恶意软件或损坏的系统映像被加载和运行。

=== DSU的实现要求： ===

* 为了启用DSU功能，系统必须配置以下内核选项：

CONFIG_DM_VERITY=y
CONFIG_DM_VERITY_FEC=y

* Google为了存储与已安装DSU镜像相关的数据需要使用 <code>metadata</code> 分区，这要求机器必须为动态分区(Dynamic Partition)

=== DSU 流程 ===
本部分介绍如何执行多个 DSU 配置流程。

==== 生成新的密钥对 ====
使用 <code>openssl</code> 命令生成 <code>.pem</code> 格式的 RSA 私钥/公钥对（例如，大小为 2048 位）：
openssl genrsa -out oem_cert_pri.pem 2048
openssl rsa -in oem_cert_pri.pem -pubout -out oem_cert_pub.pem
私钥可能无法访问，并且只保存在[[wikipedia:Hardware_security_module|硬件安全模块 (HSM)]] 中。在这种情况下，密钥生成后可能会提供 x509 公钥证书。如需了解如何通过 x509 证书生成 AVB 公钥，请参阅将配对公钥添加到 ramdisk 部分。

如需将 x509 证书转换为 PEM 格式，请运行以下命令：

<code>openssl x509 -pubkey -noout -in oem_cert_pub.x509.pem > oem_cert_pub.pem</code>

==== 将配对公钥添加到 ramdisk ====
<code>oem_cert.avbpubkey</code> 必须放在 <code>/avb/*.avbpubkey</code> 下，以验证已签名的 DSU 软件包。首先，将 PEM 格式的公钥转换为 AVB 公钥格式：

<code>avbtool extract_public_key --key oem_cert_pub.pem --output oem_cert.avbpubkey</code>

然后，按照以下步骤在第一阶段 ramdisk 中添加公钥。

* 1. 添加一个预构建模块以复制 <code>avbpubkey</code>。例如，使用如下内容可添加 <code>device/<company>/<board>/oem_cert.avbpubkey</code> 和 <code>device/<company>/<board>/avb/Android.mk</code>：

include $(CLEAR_VARS)

LOCAL_MODULE := oem_cert.avbpubkey
LOCAL_MODULE_CLASS := ETC
LOCAL_SRC_FILES := $(LOCAL_MODULE)
ifeq ($(BOARD_USES_RECOVERY_AS_BOOT),true)
LOCAL_MODULE_PATH := $(TARGET_RECOVERY_ROOT_OUT)/first_stage_ramdisk/avb
else
LOCAL_MODULE_PATH := $(TARGET_RAMDISK_OUT)/avb
endif

include $(BUILD_PREBUILT)

* 2. 让 droidcore 目标依赖于添加的 <code>oem_cert.avbpubkey</code>：

<code>droidcore: oem_cert.avbpubkey</code>

==== 在 JSON 描述符中生成 AVB 公钥属性 ====
<code>oem_cert.avbpubkey</code> 采用 AVB 公钥二进制格式。在将它放入 JSON 描述符之前，使用 SHA-1 使其可读。
sha1sum oem_cert.avbpubkey | cut -f1 -d ' '
3e62f2be9d9d813ef5........866ac72a51fd20
以下将是 JSON 描述符的 <code>pubkey</code> 属性的内容。
"images":[
{
...
"pubkey":"3e62f2be9d9d813ef5........866ac72a51fd20",
...
},

==== 对 DSU 软件包进行签名 ====
使用下列方法之一对 DSU 软件包进行签名：

* '''方法 1：重复使用通过原始 AVB 签名流程创建的工件创建 DSU 软件包。一种替代方式是从发布软件包中提取已签名的映像，并使用提取的映像直接创建 ZIP 文件。'''
* '''方法 2：在私钥可用时使用以下命令对 DSU 分区进行签名。DSU 软件包（ZIP 文件）中的每个 <code>img</code> 均会单独签名：'''
key_len=$(openssl rsa -in oem_cert_pri.pem -text | grep Private-Key | sed -e 's/.*($.*$ bit.*/\1/')
for partition in system product; do
avbtool add_hashtree_footer \
--image ${OUT}/${partition}.img \
--partition_name ${partition} \
--algorithm SHA256_RSA${key_len} \
--key oem_cert_pri.pem
done
如需详细了解如何使用 <code>avbtool</code> 添加 <code>add_hashtree_footer</code>，请参阅使用 [https://android.googlesource.com/platform/external/avb/#using-avbtool avbtool]。

==== 在本地验证 DSU 软件包 ====
建议您使用以下命令对照配对公钥验证所有本地映像：
for partition in system product; do
avbtool verify_image --image ${OUT}/${partition}.img --key oem_cert_pub.pem
done
预期的输出如下所示：
Verifying image dsu/system.img using key at oem_cert_pub.pem
vbmeta: Successfully verified footer and SHA256_RSA2048 vbmeta struct in dsu/system.img
: Successfully verified sha1 hashtree of dsu/system.img for image of 898494464 bytes

Verifying image dsu/product.img using key at oem_cert_pub.pem
vbmeta: Successfully verified footer and SHA256_RSA2048 vbmeta struct in dsu/product.img
: Successfully verified sha1 hashtree of dsu/product.img for image of 905830400 bytes

==== 创建 DSU 软件包 ====
以下示例将展示如何创建一个包含 <code>system.img</code> 和 <code>product.img</code> 的 DSU 软件包：
dsu.zip {
- system.img
- product.img
}
在两个映像均已签名后，使用以下命令创建 ZIP 文件：
mkdir -p dsu
cp ${OUT}/system.img dsu
cp ${OUT}/product.img dsu
cd dsu && zip ../dsu.zip *.img && cd -

==== 自定义一键式 DSU ====
默认情况下，DSU 加载器指向 GSI 映像的元数据，即 <code><nowiki>https://...google.com/.../gsi-src.json</nowiki></code>。

OEM 可以通过定义指向其 JSON 描述符的 <code>persist.sys.fflag.override.settings_dynamic_system.list</code> 属性来覆盖该列表。例如，OEM 可能会提供包含 GSI 和 OEM 专有映像的 JSON 元数据，如下所示：
{
"include": ["<nowiki>https://dl.google.com/.../gsi-src.JSON</nowiki>"]
"images":[
{
"name":"OEM image",
"os_version":"10",
"cpu_abi": "arm64-v8a",
"details":"...",
"vndk":[
27,
28,
29
],
"spl":"...",
"pubkey":"",
"uri":"<nowiki>https://.../....zip</nowiki>"
},
}
OEM 可以链接已发布的 DSU 元数据，如图所示。
[[文件:Dsu-metadata-chaining.png|缩略图]]

文件:Dsu-metadata-chaining.png

2024-08-06T05:50:30Z

SakuraKyuo：

OEM 链接已发布的 DSU 元数据

Android Verified Boot

2024-08-06T05:19:14Z

SakuraKyuo：微调

Android Verified Boot（AVB）是一种安全功能，旨在保护Android设备免受恶意软件和未经授权的系统修改。它通过使用数字签名和完整性检查来确保设备启动过程中的安全性。

== AVB 工作原理 ==

# 验证引导加载程序（Bootloader）：当设备的引导加载程序（即Bootloader）加载操作系统时。AVB通过验证引导加载程序其本身的完整性和数字签名来确保其未被篡改。
# 验证操作系统：在引导加载程序验证通过后，AVB会继续验证操作系统分区。这包括Android系统映像以及关键的系统文件，如系统分区和供应商分区。
# 完整性检查：AVB使用哈希函数（通常为SHA-256）来计算每个启动时加载的镜像文件的哈希值。这些哈希值与预先存储在设备上的哈希值进行比较，从而检查文件是否被篡改。
# 安全启动状态：如果设备检测到启动过程中任何验证失败或完整性检查不匹配的情况，它将进入“安全启动状态”。在这种状态下，设备通常会限制某些功能，如不允许访问加密数据、不允许加载启动系统（通常可见为卡在Logo并重启），以保护用户免安全威胁。

== AVB 通常会在哪些分区加入 ==
AVB通常会在以下几个重要分区加入验证和完整性检查：

* System 分区（System Partition）：包含Android操作系统的核心映像和关键系统文件，AVB会验证这些文件是否被篡改。

* Vendor 分区（Vendor Partition）：包含供应商提供的固件和驱动程序，AVB会对其进行验证以确保其安全性。

当涉及到动态分区（Dynamic Partition）时，Android Verified Boot（AVB）通常也会在以下几个关键分区加入验证和完整性检查：

* Product 分区（Product Partition）：该分区通常包含供应商特定的应用程序和配置文件。AVB会对Product分区进行验证，以确保其中的内容没有被篡改。

* System_ext 分区（System Extension Partition）：这个分区通常用于存放同上文件。AVB会验证System_ext分区的内容，以确保这些扩展的完整性和安全性。

* Odm 分区（Odm Partition）：该分区分区通常包含设备制造商的特定驱动程序和配置文件。AVB也会对Odm分区进行验证，以确保其中的信息没有被篡改。

通过在这些关键分区实施AVB，Android设备可以提高对未经授权修改和恶意软件的防护能力，从而增强用户数据和设备的安全性。

== 去除 AVB 验证 ==

=== '''1. 进入 Bootloader 模式'''： ===
* 首先，确保你的设备进入 Bootloader 模式。

=== '''2.禁用 AVB 验证'''： ===
* 在 Bootloader 模式下，使用 <code>fastboot</code> 命令来禁用 AVB 验证。以下是需要执行的命令：
<code>fastboot --disable-verity flash vbmeta vbmeta.img</code>
* 这条命令会将 <code>vbmeta.img</code> 文件刷入设备中，以禁用验证。请将 <code>vbmeta.img</code> 替换为本地存储的对应文件路径。
* 对于使用动态分区（Dynamic Partition）的设备，还需要以下命令：
fastboot --disable-verity flash vbmeta_system vbmeta_system.img
fastboot --disable-verity flash vbmeta_vendor vbmeta_vendor.img
* 同样，替换 <code>vbmeta_system.img</code> 和 <code>vbmeta_vendor.img</code> 为本地存储的相应文件路径。
（注意：vbmeta_vendor可能有部分动态分区并不存在，请以实际为准）

=== '''3. 重启设备'''： ===

* 完成上述操作后，重新启动设备。设备将会跳过 Android Verified Boot 的验证过程

请注意，这样做会降低设备对未经授权修改的防护能力，从而增加安全风险。在执行这些操作之前，请确保了解潜在的风险和后果，并仅在有必要的情况下进行。

Android Verified Boot

2024-08-06T05:10:59Z

SakuraKyuo：为刷入vbmeta_vendor部分添加换行

Android Verified Boot（AVB）是一种安全功能，旨在保护Android设备免受恶意软件和未经授权的系统修改。它通过使用数字签名和完整性检查来确保设备启动过程中的安全性。

== AVB 工作原理 ==

# 验证引导加载程序（Bootloader）：当设备的引导加载程序（即Bootloader）加载操作系统时。AVB通过验证引导加载程序其本身的完整性和数字签名来确保其未被篡改。
# 验证操作系统：在引导加载程序验证通过后，AVB会继续验证操作系统分区。这包括Android系统映像以及关键的系统文件，如系统分区和供应商分区。
# 完整性检查：AVB使用哈希函数（通常为SHA-256）来计算每个启动时加载的镜像文件的哈希值。这些哈希值与预先存储在设备上的哈希值进行比较，从而检查文件是否被篡改。
# 安全启动状态：如果设备检测到启动过程中任何验证失败或完整性检查不匹配的情况，它将进入“安全启动状态”。在这种状态下，设备通常会限制某些功能，如不允许访问加密数据、不允许加载启动系统（通常可见为卡在Logo并重启），以保护用户免安全威胁。

== AVB 通常会在哪些分区加入 ==
AVB通常会在以下几个重要分区加入验证和完整性检查：

* System 分区（System Partition）：包含Android操作系统的核心映像和关键系统文件，AVB会验证这些文件是否被篡改。

* Vendor 分区（Vendor Partition）：包含供应商提供的固件和驱动程序，AVB会对其进行验证以确保其安全性。

当涉及到动态分区（Dynamic Partition）时，Android Verified Boot（AVB）通常也会在以下几个关键分区加入验证和完整性检查：

* Product 分区（Product Partition）：该分区通常包含供应商特定的应用程序和配置文件。AVB会对Product分区进行验证，以确保其中的内容没有被篡改。

* System_ext 分区（System Extension Partition）：这个分区通常用于存放同上文件。AVB会验证System_ext分区的内容，以确保这些扩展的完整性和安全性。

* Odm 分区（Odm Partition）：该分区分区通常包含设备制造商的特定驱动程序和配置文件。AVB也会对Odm分区进行验证，以确保其中的信息没有被篡改。

通过在这些关键分区实施AVB，Android设备可以提高对未经授权修改和恶意软件的防护能力，从而增强用户数据和设备的安全性。

== 去除 AVB 验证 ==

# '''进入 Bootloader 模式'''：
#* 首先，确保你的设备进入 Bootloader 模式。
# '''禁用 AVB 验证'''：
#* 在 Bootloader 模式下，使用 <code>fastboot</code> 命令来禁用 AVB 验证。以下是需要执行的命令：
#* <code>fastboot --disable-verity flash vbmeta vbmeta.img</code>
#* 这条命令会将 <code>vbmeta.img</code> 文件刷入设备中，以禁用验证。请将 <code>vbmeta.img</code> 替换为本地存储的对应文件路径。
#* 对于使用动态分区（Dynamic Partition）的设备，还需要以下命令：
#* <code>fastboot --disable-verity flash vbmeta_system vbmeta_system.img</code>
#* <code>fastboot --disable-verity flash vbmeta_vendor vbmeta_vendor.img</code>（注意：vbmeta_vendor可能有部分动态分区并不存在，请以实际为准）
#* 同样，替换 <code>vbmeta_system.img</code> 和 <code>vbmeta_vendor.img</code> 为本地存储的相应文件路径。
# '''重启设备'''：
#* 完成上述操作后，重新启动设备。设备将会跳过 Android Verified Boot 的验证过程

请注意，这样做会降低设备对未经授权修改的防护能力，从而增加安全风险。在执行这些操作之前，请确保了解潜在的风险和后果，并仅在有必要的情况下进行。

Android Verified Boot

2024-08-06T05:10:21Z

SakuraKyuo：首次添加

Android Verified Boot（AVB）是一种安全功能，旨在保护Android设备免受恶意软件和未经授权的系统修改。它通过使用数字签名和完整性检查来确保设备启动过程中的安全性。

== AVB 工作原理 ==

# 验证引导加载程序（Bootloader）：当设备的引导加载程序（即Bootloader）加载操作系统时。AVB通过验证引导加载程序其本身的完整性和数字签名来确保其未被篡改。
# 验证操作系统：在引导加载程序验证通过后，AVB会继续验证操作系统分区。这包括Android系统映像以及关键的系统文件，如系统分区和供应商分区。
# 完整性检查：AVB使用哈希函数（通常为SHA-256）来计算每个启动时加载的镜像文件的哈希值。这些哈希值与预先存储在设备上的哈希值进行比较，从而检查文件是否被篡改。
# 安全启动状态：如果设备检测到启动过程中任何验证失败或完整性检查不匹配的情况，它将进入“安全启动状态”。在这种状态下，设备通常会限制某些功能，如不允许访问加密数据、不允许加载启动系统（通常可见为卡在Logo并重启），以保护用户免安全威胁。

== AVB 通常会在哪些分区加入 ==
AVB通常会在以下几个重要分区加入验证和完整性检查：

* System 分区（System Partition）：包含Android操作系统的核心映像和关键系统文件，AVB会验证这些文件是否被篡改。

* Vendor 分区（Vendor Partition）：包含供应商提供的固件和驱动程序，AVB会对其进行验证以确保其安全性。

当涉及到动态分区（Dynamic Partition）时，Android Verified Boot（AVB）通常也会在以下几个关键分区加入验证和完整性检查：

* Product 分区（Product Partition）：该分区通常包含供应商特定的应用程序和配置文件。AVB会对Product分区进行验证，以确保其中的内容没有被篡改。

* System_ext 分区（System Extension Partition）：这个分区通常用于存放同上文件。AVB会验证System_ext分区的内容，以确保这些扩展的完整性和安全性。

* Odm 分区（Odm Partition）：该分区分区通常包含设备制造商的特定驱动程序和配置文件。AVB也会对Odm分区进行验证，以确保其中的信息没有被篡改。

通过在这些关键分区实施AVB，Android设备可以提高对未经授权修改和恶意软件的防护能力，从而增强用户数据和设备的安全性。

== 去除 AVB 验证 ==

# '''进入 Bootloader 模式'''：
#* 首先，确保你的设备进入 Bootloader 模式。
# '''禁用 AVB 验证'''：
#* 在 Bootloader 模式下，使用 <code>fastboot</code> 命令来禁用 AVB 验证。以下是需要执行的命令：
#* <code>fastboot --disable-verity flash vbmeta vbmeta.img</code>
#* 这条命令会将 <code>vbmeta.img</code> 文件刷入设备中，以禁用验证。请将 <code>vbmeta.img</code> 替换为本地存储的对应文件路径。
#* 对于使用动态分区（Dynamic Partition）的设备，还需要以下命令：
#* <code>fastboot --disable-verity flash vbmeta_system vbmeta_system.img</code> <code>fastboot --disable-verity flash vbmeta_vendor vbmeta_vendor.img</code>（注意：vbmeta_vendor可能有部分动态分区并不存在，请以实际为准）
#* 同样，替换 <code>vbmeta_system.img</code> 和 <code>vbmeta_vendor.img</code> 为本地存储的相应文件路径。
# '''重启设备'''：
#* 完成上述操作后，重新启动设备。设备将会跳过 Android Verified Boot 的验证过程

请注意，这样做会降低设备对未经授权修改的防护能力，从而增加安全风险。在执行这些操作之前，请确保了解潜在的风险和后果，并仅在有必要的情况下进行。

如何解包 Android ROM

2024-02-16T14:01:45Z

SakuraKyuo：添加提醒事项

== 提醒事项 ==
注意：本教程以在 Windows 10 平台下进行解包操作为例，并确保你拥有可以访问国际网络的能力。在阅读本篇wiki前，请确保你有一定的基础。

== 格式确认 ==
在正式开始之前，你需要了解你接下来需要解包的是哪种类型的文件。本教程将介绍

# payload.bin
# super.img
# ozip格式
# br格式
# dat格式(以及vivo分段dat)
# img格式

== Payload.bin解包 ==

=== 1. 获得所需工具 - Payload dumper go([https://kkgithub.com/ssut/payload-dumper-go GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 解包 ===

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe payload.bin</code>
# 小等一会 payload.bin 内的所有文件将会解压到 output_xxx 目录内

=== 3. 进阶用法[可选] ===

==== 1. 只解包某个分区 ====

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe -p 所需分区名 payload.bin</code> (示例: <code>payload-dumper-go.exe -p system payload.bin</code> )
# 小等一会所指定的文件将会解压到 output_xxx 目录内

==== 2. 只解包部分分区 ====

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe -l payload.bin</code> 以列出 payload.bin 内所有的分区文件
# 输入 <code>payload-dumper-go.exe -p 所需分区名并以英文逗号分隔 payload.bin</code> (示例: <code>payload-dumper-go.exe -p system,vendor payload.bin</code> )
# 小等一会所指定的文件将会解压到一个名为 output_xxx 的目录内

注意：指定的顺序需要按照工具所列出的输入，否则无法正常解压指定的分区(如：system,vendor √ vendor,system ×)

== super.img 解包 ==

=== 1. 获得所需工具 - lpunpack([https://github.com/unix3dgforce/lpunpack GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 lpunpack 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python lpunpack.py super.img output</code>
# 小等一会 super.img 内的所有文件将会解压到 output 目录内

=== 3. 进阶用法[可选] ===

==== 1. 只想要某个分区 ====

# 将工具解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python lpunpack.py -p 所需分区名 super.img output</code>(示例: <code>python lpunpack.py -p system_a super.img output</code>)

=== 特别注意 ===
由于小米线刷包提供的是 sparse image(simg) 而解压 super.img 前需要转换为 raw image(rimg) 请跟随以下步骤转换

# 下载 simg2img([https://github.com/KinglyWayne/simg2img_win GitHub])
# 解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>simg2img.exe super.img super.rimg.img</code>
# 小等一会 super.img 将会转换为 raw image

注: 转换之后上面教程中的 super.img 请替换为 super.rimg.img(示例: <code>python lpunpack.py super.rimg.img output</code>)

== ozip 解包 ==

=== 1. 获得所需工具 - oppo_ozip_decrypt([https://github.com/bkerler/oppo_ozip_decrypt GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 oppo_ozip_decrypt 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 ozip 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>pip install -r requirements.txt</code> (只需运行一次即后续使用无需再次运行)
# 输入 <code>python ozipdecrypt.py Example.ozip</code> (这里的 Example.ozip 替换为你所需要解压的 ozip 文件)
# 小等一会 ozip 将会转换为 zip

== br格式解包 ==

=== 1. 获得所需工具 - brotli([https://github.com/google/brotli/releases GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 解包 ===

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli.exe -d br文件</code> (示例: <code>brotli.exe -d system.new.dat.br</code>)
# 小等一会 br文件将会被解压解压后的文件在同目录内

=== 3. 进阶使用[可选] ===

==== 1. 解包后删除源文件 ====

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli.exe -j -d br文件</code> (示例: <code>brotli.exe -j -d system.new.dat.br</code>)
# 小等一会 br文件将会被解压到同目录下同时 br文件也会被删除

== dat格式解包 ==

=== 1. 获得所需工具 - sdat2img([https://github.com/xpirt/sdat2img GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 sdat2img 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 dat文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python sdat2img.py transfer.list文件 dat文件 [输出img名]</code> (示例: <code>python sdat2img.py system.transfer.list system.new.dat system.img</code>)
# 小等一会 dat文件将会被解压解压后的文件在同目录内

注意：<code>[输出img名]</code> 为可选项不传入此参数解压得到的 img 名称默认为 system.img

=== 3. vivo 分段dat 解包 ===

# 将工具解压到 dat文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>type dat文件.* > dat文件</code> (示例: <code>type system.new.dat.* > system.new.dat</code>)
# 输入 <code>python sdat2img.py transfer.list文件 dat文件 [输出img名]</code> (示例: <code>python sdat2img.py system.transfer.list system.new.dat system.img</code>)
# 小等一会 dat文件将会被解压解压后的文件在同目录内

注意：<code>[输出img名]</code> 为可选项不传入此参数解压得到的 img 名称默认为 system.img

== img格式解包 ==

=== 特别注意 ===
本章节将分为三个部分，分别是

# ext4 格式 img 解压
# erofs 格式 img 解压
# boot/recovery类型 img 解压

=== 1. ext4 格式解包 ===

==== 1. 获得所需工具 - imgextractor & ext4 ====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

imgextractor - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/imgextractor.py GitHub] & ext4 - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/ext4.py GitHub]

访问对应链接并点击下载图标下载文件

==== 2. 解包 ====

# 将文件放置到 img文件所在目录(imgextractor.py 和 ext4.py 均需要放置)
# 在该目录下打开 cmd 命令行
# 输入 <code>python imgextractor.py img文件输出目录</code> (示例: <code>python imgextractor.py system.img system</code>)
# 小等一会 img文件将会被解压

=== 2. erofs 格式解包 ===

==== 1. 获得所需工具 - extract.erofs([https://github.com/sekaiacg/erofs-utils GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 解包 ====

# 将工具内所有文件放置到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>extract.erofs.exe -i img文件 -o 输出目录</code> (示例: <code>extract.erofs.exe -i system.img -o system</code>)
# 小等一会 img文件将会被解压

=== 3. boot/recovery类型 img 解压包 ===

==== 1. 获得所需工具 - magiskboot([https://github.com/ookiineko/magiskboot_build GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 解包 ====

# 将工具放置到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>magiskboot.exe unpack -h img文件</code> (示例: <code>magiskboot.exe unpack -h boot.img</code>)
# 小等一会 img文件将会被解压

如何打包 Android ROM

2024-02-16T13:34:32Z

SakuraKyuo：突出注意事项

== 提醒事项 ==
注意：本教程以在 Windows 10 平台下进行解包操作为例，并确保你拥有可以访问国际网络的能力

== 格式确认 ==
在正式开始之前，你需要了解你接下来需要打包的是哪种类型的文件。本教程将介绍

# img格式
# dat格式
# br格式

== img格式打包 ==

=== 特别注意 ===
本章节将分为三个部分，分别是

# ext4 格式 img 打包
# erofs 格式 img 打包
# boot/recovery类型 img 打包

=== 1. ext4 格式打包 ===
本部分将分为两个部分(两种打包方式)，分别是

# 通过 make_ext4fs 打包
# 通过 mke2fs + e2fsdroid 打包

==== 1. 通过 make_ext4fs 打包 ====

===== 1.获得所需工具 - make_ext4fs([https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/make_ext4fs.exe GitHub]) =====
访问工具链接并点击下载图标下载文件

===== 2. 打包 =====
# 将工具放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 记录 config\分区名_size.txt 内数值
# 输入 <code>make_ext4fs.exe -J -T 1167580800 -S config\分区名_file_contexts -l 上一步记录的数值 -C config\分区名_fs_config -L 分区名 -a 分区名打包文件名分区文件夹名</code> (示例: <code>make_ext4fs.exe -J -T 1167580800 -S config\vendor_file_contexts -l 1145141919 -C config\vendor_fs_config -L vendor -a vendor vendor_new.img vendor</code>)
# 小等一会将会打包完成

===== 注意 =====
打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。如果您的机器是动态分区，请参考第二种打包方式

正确存放示例：vendor config make_ext4fs.exe

==== 2. 通过 mke2fs + e2fsdroid 打包 ====

===== 1. 获得所需工具 - mke2fs + e2fsdroid =====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

mke2fs - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/mke2fs.exe GitHub]

e2fsdroid - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/e2fsdroid.exe GitHub]

工具运行库 - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/cygwin1.dll GitHub]

访问对应链接并点击下载图标下载文件

fspatch - [https://github.com/affggh/fspatch GitHub]

访问 fspatch 仓库并点击 Code - Download zip 下载

===== 2. 打包 =====

# 将工具及运行库放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python fspatch.py 分区文件夹名 config\分区名_fs_config</code> (示例: <code>python fspatch.py vendor config\vendor_fs_config</code>)
# 记录 config\分区名_size.txt 内数值，并除以 4096 后的数值(示例: 11451419 除以 4096)。如果有小数点(如 114514.19)，请去除小数点并加1(即 114515)
# 输入 <code>mke2fs -O ^has_journal -L 分区名 -I 256 -M /分区名 -m 0 -t ext4 -b 4096 打包文件名上一步记录的数值</code> (示例: <code>mke2fs -O ^has_journal -L vendor -I 256 -M /vendor -m 0 -t ext4 -b 4096 vendor_new.img 114515</code>)
# 输入 <code>e2fsdroid -e -T 1167580800 -S 分区名_fs_config的绝对路径 -C 分区名_fs_config的绝对路径 -a /分区名 -f 分区文件夹名上一步输入的打包文件名</code> (示例: <code>e2fsdroid -e -T 1167580800 -S D:\homo\config\vendor_file_contexts -C D:\homo\config\vendor_fs_config -a /vendor -f vendor vendor_new.img</code>)
# 小等一会将会打包完成

===== 注意 =====

# 打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。
# 正确存放示例：vendor config mke2fs.exe e2fsdroid.exe cygwin1.dll fspatch.py

=== 2. erofs 格式打包 ===

==== 1. 获得所需工具 - mkfs.erofs ====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

mkfs.erofs - [https://github.com/sekaiacg/erofs-utils GitHub]

请访问工具 GitHub 仓库并从 Release 内下载工具

fspatch - [https://github.com/affggh/fspatch GitHub]

访问 fspatch 仓库并点击 Code - Download zip 下载

==== 2. 打包 ====

# 将工具内所有文件放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python fspatch.py 分区文件夹名 config\分区名_fs_config</code> (示例: <code>python fspatch.py vendor config\vendor_fs_config</code>)
# 输入 <code>mkfs.erofs -zlz4hc,8 -T 1167580800 --mount-point=/分区名 --fs-config-file=分区名_fs_config的绝对路径 --file-contexts=分区名_file_contexts的绝对路径打包文件名分区文件夹名</code> (示例: <code>mkfs.erofs -zlz4hc,8 -T 1167580800 --mount-point=/vendor --fs-config-file=D:\homo\config\vendor_fs_config --file-contexts=D:\homo\config\vendor_file_contexts vendor_new.img vendor</code>)
# 小等一会将会打包完成

===== 注意 =====

# 打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。
# 正确存放示例：vendor config mkfs.erofs.exe winfsp-x64.dll cygwin1.dll fspatch.py

=== 3. boot/recovery类型 img 打包 ===

==== 1. 获得所需工具 - magiskboot([https://github.com/ookiineko/magiskboot_build GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 打包 ====

# 将工具放置到所需打包boot/recovery 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>magiskboot.exe repack 原img文件新img文件</code> (示例: <code>magiskboot.exe repack boot.img boot_new.img</code>)
# 小等一会将会打包完成

===== 注意 =====

# 请严格按照解包教程内的解包方法操作才可使用本方法进行打包

== dat格式打包 ==

=== 1. 获得所需工具 - img2sdat([https://kkgithub.com/xpirt/img2sdat GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 img2sdat 仓库并点击 Code - Download zip 下载

=== 2. 打包 ===

# 将工具解压到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python img2sdat.py img文件 -v 4 [-p 分区名]</code> (示例: <code>python img2sdat.py system.img -v 4 -p system</code>)
# 小等一会将会打包完成

===== 注意 =====

# <code>[-p 分区名]</code> 为可选项不传入此参数打包得到的 dat 名称默认为 <code>system.new.dat</code>, <code>system.patch.dat</code>, <code>system.transfer.list</code>

== br格式打包 ==

=== 1. 获得所需工具 - brotli([https://github.com/google/brotli/releases GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 打包 ===

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli -q 5 dat文件 -o 输出的br文件</code> (示例: <code>brotli -q 5 system.new.dat -o system.new.dat.br</code>)
# 小等一会 br文件将会被解压解压后的文件在同目录

===== 注意 =====

# -q 后的数字为压缩等级，可选1 - 9，数字越大压缩率越高耗时越长

如何打包 Android ROM

2024-02-16T13:31:34Z

SakuraKyuo：修正目录错误

== 提醒事项 ==
注意：本教程以在 Windows 10 平台下进行解包操作为例，并确保你拥有可以访问国际网络的能力

== 格式确认 ==
在正式开始之前，你需要了解你接下来需要打包的是哪种类型的文件。本教程将介绍

# img格式
# dat格式
# br格式

== img格式打包 ==

=== 特别注意 ===
本章节将分为三个部分，分别是

# ext4 格式 img 打包
# erofs 格式 img 打包
# boot/recovery类型 img 打包

=== 1. ext4 格式打包 ===
本部分将分为两个部分(两种打包方式)，分别是

# 通过 make_ext4fs 打包
# 通过 mke2fs + e2fsdroid 打包

==== 1. 通过 make_ext4fs 打包 ====

===== 1.获得所需工具 - make_ext4fs([https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/make_ext4fs.exe GitHub]) =====
访问工具链接并点击下载图标下载文件

===== 2. 打包 =====
# 将工具放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 记录 config\分区名_size.txt 内数值
# 输入 <code>make_ext4fs.exe -J -T 1167580800 -S config\分区名_file_contexts -l 上一步记录的数值 -C config\分区名_fs_config -L 分区名 -a 分区名打包文件名分区文件夹名</code> (示例: <code>make_ext4fs.exe -J -T 1167580800 -S config\vendor_file_contexts -l 1145141919 -C config\vendor_fs_config -L vendor -a vendor vendor_new.img vendor</code>)
# 小等一会将会打包完成

注意：打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。如果您的机器是动态分区，请参考第二种打包方式

正确存放示例：vendor config make_ext4fs.exe

==== 2. 通过 mke2fs + e2fsdroid 打包 ====

===== 1. 获得所需工具 - mke2fs + e2fsdroid =====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

mke2fs - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/mke2fs.exe GitHub]

e2fsdroid - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/e2fsdroid.exe GitHub]

工具运行库 - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/cygwin1.dll GitHub]

访问对应链接并点击下载图标下载文件

fspatch - [https://github.com/affggh/fspatch GitHub]

访问 fspatch 仓库并点击 Code - Download zip 下载

===== 2. 打包 =====

# 将工具及运行库放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python fspatch.py 分区文件夹名 config\分区名_fs_config</code> (示例: <code>python fspatch.py vendor config\vendor_fs_config</code>)
# 记录 config\分区名_size.txt 内数值，并除以 4096 后的数值(示例: 11451419 除以 4096)。如果有小数点(如 114514.19)，请去除小数点并加1(即 114515)
# 输入 <code>mke2fs -O ^has_journal -L 分区名 -I 256 -M /分区名 -m 0 -t ext4 -b 4096 打包文件名上一步记录的数值</code> (示例: <code>mke2fs -O ^has_journal -L vendor -I 256 -M /vendor -m 0 -t ext4 -b 4096 vendor_new.img 114515</code>)
# 输入 <code>e2fsdroid -e -T 1167580800 -S 分区名_fs_config的绝对路径 -C 分区名_fs_config的绝对路径 -a /分区名 -f 分区文件夹名上一步输入的打包文件名</code> (示例: <code>e2fsdroid -e -T 1167580800 -S D:\homo\config\vendor_file_contexts -C D:\homo\config\vendor_fs_config -a /vendor -f vendor vendor_new.img</code>)
# 小等一会将会打包完成

注意：打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。

正确存放示例：vendor config mke2fs.exe e2fsdroid.exe cygwin1.dll fspatch.py

=== 2. erofs 格式打包 ===

==== 1. 获得所需工具 - mkfs.erofs ====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

mkfs.erofs - [https://github.com/sekaiacg/erofs-utils GitHub]

请访问工具 GitHub 仓库并从 Release 内下载工具

fspatch - [https://github.com/affggh/fspatch GitHub]

访问 fspatch 仓库并点击 Code - Download zip 下载

==== 2. 打包 ====

# 将工具内所有文件放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python fspatch.py 分区文件夹名 config\分区名_fs_config</code> (示例: <code>python fspatch.py vendor config\vendor_fs_config</code>)
# 输入 <code>mkfs.erofs -zlz4hc,8 -T 1167580800 --mount-point=/分区名 --fs-config-file=分区名_fs_config的绝对路径 --file-contexts=分区名_file_contexts的绝对路径打包文件名分区文件夹名</code> (示例: <code>mkfs.erofs -zlz4hc,8 -T 1167580800 --mount-point=/vendor --fs-config-file=D:\homo\config\vendor_fs_config --file-contexts=D:\homo\config\vendor_file_contexts vendor_new.img vendor</code>)
# 小等一会将会打包完成

注意：打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。

正确存放示例：vendor config mkfs.erofs.exe winfsp-x64.dll cygwin1.dll fspatch.py

=== 3. boot/recovery类型 img 打包 ===

==== 1. 获得所需工具 - magiskboot([https://github.com/ookiineko/magiskboot_build GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 打包 ====

# 将工具放置到所需打包boot/recovery 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>magiskboot.exe repack 原img文件新img文件</code> (示例: <code>magiskboot.exe repack boot.img boot_new.img</code>)
# 小等一会将会打包完成

注意：请严格按照解包教程内的解包方法操作才可使用本方法进行打包

== dat格式打包 ==

=== 1. 获得所需工具 - img2sdat([https://kkgithub.com/xpirt/img2sdat GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 img2sdat 仓库并点击 Code - Download zip 下载

=== 2. 打包 ===

# 将工具解压到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python img2sdat.py img文件 -v 4 [-p 分区名]</code> (示例: <code>python img2sdat.py system.img -v 4 -p system</code>)
# 小等一会将会打包完成

注意：<code>[-p 分区名]</code> 为可选项不传入此参数打包得到的 dat 名称默认为 <code>system.new.dat</code>, <code>system.patch.dat</code>, <code>system.transfer.list</code>

== br格式打包 ==

=== 1. 获得所需工具 - brotli([https://github.com/google/brotli/releases GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 打包 ===

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli -q 5 dat文件 -o 输出的br文件</code> (示例: <code>brotli -q 5 system.new.dat -o system.new.dat.br</code>)
# 小等一会 br文件将会被解压解压后的文件在同目录

注意：-q 后的数字为压缩等级，可选1 - 9，数字越大压缩率越高耗时越长

如何打包 Android ROM

2024-02-16T13:28:28Z

SakuraKyuo：首次编写

== 提醒事项 ==
注意：本教程以在 Windows 10 平台下进行解包操作为例，并确保你拥有可以访问国际网络的能力

== 格式确认 ==
在正式开始之前，你需要了解你接下来需要打包的是哪种类型的文件。本教程将介绍

# img格式
# dat格式
# br格式

== img格式打包 ==

=== 特别注意 ===
本章节将分为三个部分，分别是

# ext4 格式 img 打包
# erofs 格式 img 打包
# boot/recovery类型 img 打包

=== 1. ext4 格式打包 ===
本部分将分为两个部分(两种打包方式)，分别是

# 通过 make_ext4fs 打包
# 通过 mke2fs + e2fsdroid 打包

==== 1. 通过 make_ext4fs 打包 ====

===== 1.获得所需工具 - make_ext4fs([https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/make_ext4fs.exe GitHub]) =====
访问工具链接并点击下载图标下载文件

==== 2. 打包 ====

# 将工具放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 记录 config\分区名_size.txt 内数值
# 输入 <code>make_ext4fs.exe -J -T 1167580800 -S config\分区名_file_contexts -l 上一步记录的数值 -C config\分区名_fs_config -L 分区名 -a 分区名打包文件名分区文件夹名</code> (示例: <code>make_ext4fs.exe -J -T 1167580800 -S config\vendor_file_contexts -l 1145141919 -C config\vendor_fs_config -L vendor -a vendor vendor_new.img vendor</code>)
# 小等一会将会打包完成

注意：打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。如果您的机器是动态分区，请参考第二种打包方式

正确存放示例：vendor config make_ext4fs.exe

==== 2. 通过 mke2fs + e2fsdroid 打包 ====

===== 1. 获得所需工具 - mke2fs + e2fsdroid =====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

mke2fs - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/mke2fs.exe GitHub]

e2fsdroid - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/e2fsdroid.exe GitHub]

工具运行库 - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/bin/Windows/AMD64/cygwin1.dll GitHub]

访问对应链接并点击下载图标下载文件

fspatch - [https://github.com/affggh/fspatch GitHub]

访问 fspatch 仓库并点击 Code - Download zip 下载

===== 2. 打包 =====

# 将工具及运行库放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python fspatch.py 分区文件夹名 config\分区名_fs_config</code> (示例: <code>python fspatch.py vendor config\vendor_fs_config</code>)
# 记录 config\分区名_size.txt 内数值，并除以 4096 后的数值(示例: 11451419 除以 4096)。如果有小数点(如 114514.19)，请去除小数点并加1(即 114515)
# 输入 <code>mke2fs -O ^has_journal -L 分区名 -I 256 -M /分区名 -m 0 -t ext4 -b 4096 打包文件名上一步记录的数值</code> (示例: <code>mke2fs -O ^has_journal -L vendor -I 256 -M /vendor -m 0 -t ext4 -b 4096 vendor_new.img 114515</code>)
# 输入 <code>e2fsdroid -e -T 1167580800 -S 分区名_fs_config的绝对路径 -C 分区名_fs_config的绝对路径 -a /分区名 -f 分区文件夹名上一步输入的打包文件名</code> (示例: <code>e2fsdroid -e -T 1167580800 -S D:\homo\config\vendor_file_contexts -C D:\homo\config\vendor_fs_config -a /vendor -f vendor vendor_new.img</code>)
# 小等一会将会打包完成

注意：打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。

正确存放示例：vendor config mke2fs.exe e2fsdroid.exe cygwin1.dll fspatch.py

=== 2. erofs 格式打包 ===

==== 1. 获得所需工具 - mkfs.erofs ====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

mkfs.erofs - [https://github.com/sekaiacg/erofs-utils GitHub]

请访问工具 GitHub 仓库并从 Release 内下载工具

fspatch - [https://github.com/affggh/fspatch GitHub]

访问 fspatch 仓库并点击 Code - Download zip 下载

==== 2. 打包 ====

# 将工具内所有文件放置到所需打包分区所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python fspatch.py 分区文件夹名 config\分区名_fs_config</code> (示例: <code>python fspatch.py vendor config\vendor_fs_config</code>)
# 输入 <code>mkfs.erofs -zlz4hc,8 -T 1167580800 --mount-point=/分区名 --fs-config-file=分区名_fs_config的绝对路径 --file-contexts=分区名_file_contexts的绝对路径打包文件名分区文件夹名</code> (示例: <code>mkfs.erofs -zlz4hc,8 -T 1167580800 --mount-point=/vendor --fs-config-file=D:\homo\config\vendor_fs_config --file-contexts=D:\homo\config\vendor_file_contexts vendor_new.img vendor</code>)
# 小等一会将会打包完成

注意：打包要求您的文件需要严格按照解包后的结构(即所需打包文件夹 + config文件夹)存放，避免造成找不到文件的情况。

正确存放示例：vendor config mkfs.erofs.exe winfsp-x64.dll cygwin1.dll fspatch.py

=== 3. boot/recovery类型 img 打包 ===

==== 1. 获得所需工具 - magiskboot([https://github.com/ookiineko/magiskboot_build GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 打包 ====

# 将工具放置到所需打包boot/recovery 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>magiskboot.exe repack 原img文件新img文件</code> (示例: <code>magiskboot.exe repack boot.img boot_new.img</code>)
# 小等一会将会打包完成

注意：请严格按照解包教程内的解包方法操作才可使用本方法进行打包

== dat格式打包 ==

=== 1. 获得所需工具 - img2sdat([https://kkgithub.com/xpirt/img2sdat GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 img2sdat 仓库并点击 Code - Download zip 下载

=== 2. 打包 ===

# 将工具解压到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python img2sdat.py img文件 -v 4 [-p 分区名]</code> (示例: <code>python img2sdat.py system.img -v 4 -p system</code>)
# 小等一会将会打包完成

注意：<code>[-p 分区名]</code> 为可选项不传入此参数打包得到的 dat 名称默认为 <code>system.new.dat</code>, <code>system.patch.dat</code>, <code>system.transfer.list</code>

== br格式打包 ==

=== 1. 获得所需工具 - brotli([https://github.com/google/brotli/releases GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 打包 ===

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli -q 5 dat文件 -o 输出的br文件</code> (示例: <code>brotli -q 5 system.new.dat -o system.new.dat.br</code>)
# 小等一会 br文件将会被解压解压后的文件在同目录

注意：-q 后的数字为压缩等级，可选1 - 9，数字越大压缩率越高耗时越长

如何解包 Android ROM

2024-02-16T11:37:32Z

SakuraKyuo：新增 vivo dat文件解包

== 提醒事项 ==
注意：本教程以在 Windows 10 平台下进行解包操作为例，并确保你拥有可以访问国际网络的能力

== 格式确认 ==
在正式开始之前，你需要了解你接下来需要解包的是哪种类型的文件。本教程将介绍

# payload.bin
# super.img
# ozip格式
# br格式
# dat格式(以及vivo分段dat)
# img格式

== Payload.bin解包 ==

=== 1. 获得所需工具 - Payload dumper go([https://kkgithub.com/ssut/payload-dumper-go GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 解包 ===

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe payload.bin</code>
# 小等一会 payload.bin 内的所有文件将会解压到 output_xxx 目录内

=== 3. 进阶用法[可选] ===

==== 1. 只解包某个分区 ====

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe -p 所需分区名 payload.bin</code> (示例: <code>payload-dumper-go.exe -p system payload.bin</code> )
# 小等一会所指定的文件将会解压到 output_xxx 目录内

==== 2. 只解包部分分区 ====

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe -l payload.bin</code> 以列出 payload.bin 内所有的分区文件
# 输入 <code>payload-dumper-go.exe -p 所需分区名并以英文逗号分隔 payload.bin</code> (示例: <code>payload-dumper-go.exe -p system,vendor payload.bin</code> )
# 小等一会所指定的文件将会解压到一个名为 output_xxx 的目录内

注意：指定的顺序需要按照工具所列出的输入，否则无法正常解压指定的分区(如：system,vendor √ vendor,system ×)

== super.img 解包 ==

=== 1. 获得所需工具 - lpunpack([https://github.com/unix3dgforce/lpunpack GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 lpunpack 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python lpunpack.py super.img output</code>
# 小等一会 super.img 内的所有文件将会解压到 output 目录内

=== 3. 进阶用法[可选] ===

==== 1. 只想要某个分区 ====

# 将工具解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python lpunpack.py -p 所需分区名 super.img output</code>(示例: <code>python lpunpack.py -p system_a super.img output</code>)

=== 特别注意 ===
由于小米线刷包提供的是 sparse image(simg) 而解压 super.img 前需要转换为 raw image(rimg) 请跟随以下步骤转换

# 下载 simg2img([https://github.com/KinglyWayne/simg2img_win GitHub])
# 解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>simg2img.exe super.img super.rimg.img</code>
# 小等一会 super.img 将会转换为 raw image

注: 转换之后上面教程中的 super.img 请替换为 super.rimg.img(示例: <code>python lpunpack.py super.rimg.img output</code>)

== ozip 解包 ==

=== 1. 获得所需工具 - oppo_ozip_decrypt([https://github.com/bkerler/oppo_ozip_decrypt GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 oppo_ozip_decrypt 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 ozip 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>pip install -r requirements.txt</code> (只需运行一次即后续使用无需再次运行)
# 输入 <code>python ozipdecrypt.py Example.ozip</code> (这里的 Example.ozip 替换为你所需要解压的 ozip 文件)
# 小等一会 ozip 将会转换为 zip

== br格式解包 ==

=== 1. 获得所需工具 - brotli([https://github.com/google/brotli/releases GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 解包 ===

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli.exe -d br文件</code> (示例: <code>brotli.exe -d system.new.dat.br</code>)
# 小等一会 br文件将会被解压解压后的文件在同目录内

=== 3. 进阶使用[可选] ===

==== 1. 解包后删除源文件 ====

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli.exe -j -d br文件</code> (示例: <code>brotli.exe -j -d system.new.dat.br</code>)
# 小等一会 br文件将会被解压到同目录下同时 br文件也会被删除

== dat格式解包 ==

=== 1. 获得所需工具 - sdat2img([https://github.com/xpirt/sdat2img GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 sdat2img 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 dat文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python sdat2img.py transfer.list文件 dat文件 [输出img名]</code> (示例: <code>python sdat2img.py system.transfer.list system.new.dat system.img</code>)
# 小等一会 dat文件将会被解压解压后的文件在同目录内

注意：<code>[输出img名]</code> 为可选项不传入此参数解压得到的 img 名称默认为 system.img

=== 3. vivo 分段dat 解包 ===

# 将工具解压到 dat文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>type dat文件.* > dat文件</code> (示例: <code>type system.new.dat.* > system.new.dat</code>)
# 输入 <code>python sdat2img.py transfer.list文件 dat文件 [输出img名]</code> (示例: <code>python sdat2img.py system.transfer.list system.new.dat system.img</code>)
# 小等一会 dat文件将会被解压解压后的文件在同目录内

注意：<code>[输出img名]</code> 为可选项不传入此参数解压得到的 img 名称默认为 system.img

== img格式解包 ==

=== 特别注意 ===
本章节将分为三个部分，分别是

# ext4 格式 img 解压
# erofs 格式 img 解压
# boot/recovery类型 img 解压

=== 1. ext4 格式解包 ===

==== 1. 获得所需工具 - imgextractor & ext4 ====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

imgextractor - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/imgextractor.py GitHub] & ext4 - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/ext4.py GitHub]

访问对应链接并点击下载图标下载文件

==== 2. 解包 ====

# 将文件放置到 img文件所在目录(imgextractor.py 和 ext4.py 均需要放置)
# 在该目录下打开 cmd 命令行
# 输入 <code>python imgextractor.py img文件输出目录</code> (示例: <code>python imgextractor.py system.img system</code>)
# 小等一会 img文件将会被解压

=== 2. erofs 格式解包 ===

==== 1. 获得所需工具 - extract.erofs([https://github.com/sekaiacg/erofs-utils GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 解包 ====

# 将工具内所有文件放置到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>extract.erofs.exe -i img文件 -o 输出目录</code> (示例: <code>extract.erofs.exe -i system.img -o system</code>)
# 小等一会 img文件将会被解压

=== 3. boot/recovery类型 img 解压包 ===

==== 1. 获得所需工具 - magiskboot([https://github.com/ookiineko/magiskboot_build GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 解包 ====

# 将工具放置到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>magiskboot.exe unpack -h img文件</code> (示例: <code>magiskboot.exe unpack -h boot.img</code>)
# 小等一会 img文件将会被解压

如何解包 Android ROM

2024-02-16T11:29:38Z

SakuraKyuo：首次编写

== 提醒事项 ==
注意：本教程以在 Windows 10 平台下进行解包操作为例，并确保你拥有可以访问国际网络的能力

== 格式确认 ==
在正式开始之前，你需要了解你接下来需要解包的是哪种类型的文件。本教程将介绍

# payload.bin
# super.img
# ozip格式
# br格式
# dat格式(以及vivo分段dat)
# img格式

== Payload.bin解包 ==

=== 1. 获得所需工具 - Payload dumper go([https://kkgithub.com/ssut/payload-dumper-go GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 解包 ===

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe payload.bin</code>
# 小等一会 payload.bin 内的所有文件将会解压到 output_xxx 目录内

=== 3. 进阶用法[可选] ===

==== 1. 只解包某个分区 ====

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe -p 所需分区名 payload.bin</code> (示例: <code>payload-dumper-go.exe -p system payload.bin</code> )
# 小等一会所指定的文件将会解压到 output_xxx 目录内

==== 2. 只解包部分分区 ====

# 将工具解压到 payload.bin 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>payload-dumper-go.exe -l payload.bin</code> 以列出 payload.bin 内所有的分区文件
# 输入 <code>payload-dumper-go.exe -p 所需分区名并以英文逗号分隔 payload.bin</code> (示例: <code>payload-dumper-go.exe -p system,vendor payload.bin</code> )
# 小等一会所指定的文件将会解压到一个名为 output_xxx 的目录内

注意：指定的顺序需要按照工具所列出的输入，否则无法正常解压指定的分区(如：system,vendor √ vendor,system ×)

== super.img 解包 ==

=== 1. 获得所需工具 - lpunpack([https://github.com/unix3dgforce/lpunpack GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 lpunpack 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python lpunpack.py super.img output</code>
# 小等一会 super.img 内的所有文件将会解压到 output 目录内

=== 3. 进阶用法[可选] ===

==== 1. 只想要某个分区 ====

# 将工具解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python lpunpack.py -p 所需分区名 super.img output</code>(示例: <code>python lpunpack.py -p system_a super.img output</code>)

=== 特别注意 ===
由于小米线刷包提供的是 sparse image(simg) 而解压 super.img 前需要转换为 raw image(rimg) 请跟随以下步骤转换

# 下载 simg2img([https://github.com/KinglyWayne/simg2img_win GitHub])
# 解压到 super.img 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>simg2img.exe super.img super.rimg.img</code>
# 小等一会 super.img 将会转换为 raw image

注: 转换之后上面教程中的 super.img 请替换为 super.rimg.img(示例: <code>python lpunpack.py super.rimg.img output</code>)

== ozip 解包 ==

=== 1. 获得所需工具 - oppo_ozip_decrypt([https://github.com/bkerler/oppo_ozip_decrypt GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 oppo_ozip_decrypt 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 ozip 所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>pip install -r requirements.txt</code> (只需运行一次即后续使用无需再次运行)
# 输入 <code>python ozipdecrypt.py Example.ozip</code> (这里的 Example.ozip 替换为你所需要解压的 ozip 文件)
# 小等一会 ozip 将会转换为 zip

== br格式解包 ==

=== 1. 获得所需工具 - brotli([https://github.com/google/brotli/releases GitHub]) ===
请访问工具 GitHub 仓库并从 Release 内下载工具

=== 2. 解包 ===

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli.exe -d br文件</code> (示例: <code>brotli.exe -d system.new.dat.br</code>)
# 小等一会 br文件将会被解压解压后的文件在同目录内

=== 3. 进阶使用[可选] ===

==== 1. 解包后删除源文件 ====

# 将工具解压到 br文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>brotli.exe -j -d br文件</code> (示例: <code>brotli.exe -j -d system.new.dat.br</code>)
# 小等一会 br文件将会被解压到同目录下同时 br文件也会被删除

== dat格式解包 ==

=== 1. 获得所需工具 - sdat2img([https://github.com/xpirt/sdat2img GitHub]) ===
所需环境: Python([https://www.python.org/ 官网])

访问 sdat2img 仓库并点击 Code - Download zip 下载

=== 2. 解包 ===

# 将工具解压到 dat文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>python sdat2img.py transfer.list文件 dat文件 [输出img名]</code> (示例: <code>python sdat2img.py system.transfer.list system.new.dat system.img</code>)
# 小等一会 dat文件将会被解压解压后的文件在同目录内

注意：<code>[输出img名]</code> 为可选项不传入此参数解压得到的 img 名称默认为 system.img

=== 3. vivo 分段dat 解包 ===
暂未编写

== img格式解包 ==

=== 特别注意 ===
本章节将分为三个部分，分别是

# ext4 格式 img 解压
# erofs 格式 img 解压
# boot/recovery类型 img 解压

=== 1. ext4 格式解包 ===

==== 1. 获得所需工具 - imgextractor & ext4 ====
所需环境: Python([https://www.python.org/ 官网])

所需工具:

imgextractor - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/imgextractor.py GitHub] & ext4 - [https://github.com/ColdWindScholar/MIO-KITCHEN-SOURCE/blob/main/ext4.py GitHub]

访问对应链接并点击下载图标下载文件

==== 2. 解包 ====

# 将文件放置到 img文件所在目录(imgextractor.py 和 ext4.py 均需要放置)
# 在该目录下打开 cmd 命令行
# 输入 <code>python imgextractor.py img文件输出目录</code> (示例: <code>python imgextractor.py system.img system</code>)
# 小等一会 img文件将会被解压

=== 2. erofs 格式解包 ===

==== 1. 获得所需工具 - extract.erofs([https://github.com/sekaiacg/erofs-utils GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 解包 ====

# 将工具内所有文件放置到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>extract.erofs.exe -i img文件 -o 输出目录</code> (示例: <code>extract.erofs.exe -i system.img -o system</code>)
# 小等一会 img文件将会被解压

=== 3. boot/recovery类型 img 解压包 ===

==== 1. 获得所需工具 - magiskboot([https://github.com/ookiineko/magiskboot_build GitHub]) ====
请访问工具 GitHub 仓库并从 Release 内下载工具

==== 2. 解包 ====

# 将工具放置到 img文件所在目录
# 在该目录下打开 cmd 命令行
# 输入 <code>magiskboot.exe unpack -h img文件</code> (示例: <code>magiskboot.exe unpack -h boot.img</code>)
# 小等一会 img文件将会被解压