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

首页

2024-03-10T13:05:32Z

Iibchara-dev：/* 欢迎来到 120px · 刷机百科 */

= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =

'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

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

== 进阶内容 ==
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[修改分区]]
# [[QCN]]

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

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

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

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[小白测评]]
# [[微积分WekiHome]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
# [[派大宝UI]]
# [[我可以等你十年]]
# [[某贼]]
# [[凡生TalkING]]
注：以上排名不分先后

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

== 更多词条 ==
# [[设备代号收录集合]]
# [[通用系统镜像]]
# [[AOSP]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

首页

2024-03-01T11:28:54Z

Iibchara-dev：/* 欢迎来到 120px · 刷机百科 */

= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =

'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

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

== 进阶内容 ==
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[Android Verified Boot|AVB（Android Verified Boot）]]
# [[Super Empty|Super empty]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[修改分区]]
# [[QCN]]

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

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

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

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[小白测评]]
# [[微积分WekiHome]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
# [[派大宝UI]]
# [[我可以等你十年]]
# [[某贼]]
# [[凡生TalkING]]
注：以上排名不分先后

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

== 更多词条 ==
# [[设备代号收录集合]]
# [[通用系统镜像]]
# [[AOSP]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

如何打包 Android ROM

2024-02-16T18:30:02Z

Iibchara-dev：/* 2. 打包 */

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

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

# [[#img格式打包|'''img格式''']]
# [[#dat格式打包|'''dat格式''']]
# [[#br格式打包|'''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] =====
<p style="color: gray;">访问工具链接并点击 '''下载图标''' 下载文件</p>

===== 2. 打包 =====
# 将工具放置到'''所需打包分区'''所在目录
# 在'''该目录'''下打开 cmd 命令行
# 记录 '''config\分区名_size.txt''' 内数值
# 输入：<pre>make_ext4fs.exe -J -T 1167580800 -S config\分区名_file_contexts -l 上一步记录的数值 -C config\分区名_fs_config -L 分区名 -a 分区名打包文件名分区文件夹名</pre>示例：<pre>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</pre>
# 小等一会将会打包完成

===== 注意 =====
* 打包要求您的文件需要'''严格按照解包后的结构'''（即'''所需打包文件夹 + config文件夹'''）存放，避免造成找不到文件的情况。如果您的机器是动态分区，请参考第二种打包方式
* 正确存放示例：<code>vendor config make_ext4fs.exe</code>

==== 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]

<p style="color: gray;">访问对应链接并点击 '''下载图标''' 下载文件</p>

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

<p style="color: gray;">访问 fspatch 仓库并点击 '''Code - Download zip''' 下载</p>

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

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

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

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

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

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

所需工具:
* mkfs.erofs - [https://github.com/sekaiacg/erofs-utils GitHub]
<p style="color: gray;">访问工具 GitHub 仓库并从 '''Release''' 内下载工具</p>
* fspatch - [https://github.com/affggh/fspatch GitHub]
<p style="color: gray;">访问 fspatch 仓库并点击 '''Code - Download zip''' 下载</p>

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

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

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

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

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

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

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

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

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

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

== dat格式打包 ==

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

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

=== 2. 打包 ===

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

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

# <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 命令行
# 输入：<pre>brotli -q 5 dat文件 -o 输出的br文件</pre>示例：<pre>brotli -q 5 system.new.dat -o system.new.dat.br</pre>
# 小等一会，br文件将会被解压，解压后的文件在'''同目录'''

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

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

如何解包 Android ROM

2024-02-16T16:41:50Z

Iibchara-dev：

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

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

# [[#Payload.bin解包|'''payload.bin''']]
# [[#super.img 解包|'''super.img''']]
# [[#ozip 解包|'''ozip格式''']]
# [[#br格式解包|'''br格式''']]
# [[#dat格式解包|'''dat格式(以及vivo分段dat)''']]
# [[#img格式解包|'''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-16T16:09:36Z

Iibchara-dev：/* 提醒事项 */

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

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

# [[#img格式打包|'''img格式''']]
# [[#dat格式打包|'''dat格式''']]
# [[#br格式打包|'''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] =====
<p style="color: gray;">访问工具链接并点击 '''下载图标''' 下载文件</p>

===== 2. 打包 =====
# 将工具放置到'''所需打包分区'''所在目录
# 在'''该目录'''下打开 cmd 命令行
# 记录 '''config\分区名_size.txt''' 内数值
# 输入：<pre>make_ext4fs.exe -J -T 1167580800 -S config\分区名_file_contexts -l 上一步记录的数值 -C config\分区名_fs_config -L 分区名 -a 分区名打包文件名分区文件夹名</pre>示例：<pre>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</pre>
# 小等一会将会打包完成

===== 注意 =====
* 打包要求您的文件需要'''严格按照解包后的结构'''（即'''所需打包文件夹 + config文件夹'''）存放，避免造成找不到文件的情况。如果您的机器是动态分区，请参考第二种打包方式
* 正确存放示例：<code>vendor config make_ext4fs.exe</code>

==== 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]

<p style="color: gray;">访问对应链接并点击 '''下载图标''' 下载文件</p>

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

<p style="color: gray;">访问 fspatch 仓库并点击 '''Code - Download zip''' 下载</p>

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

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

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

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

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

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

所需工具:
* mkfs.erofs - [https://github.com/sekaiacg/erofs-utils GitHub]
<p style="color: gray;">访问工具 GitHub 仓库并从 '''Release''' 内下载工具</p>
* fspatch - [https://github.com/affggh/fspatch GitHub]
<p style="color: gray;">访问 fspatch 仓库并点击 '''Code - Download zip''' 下载</p>

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

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

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

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

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

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

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

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

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

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

== dat格式打包 ==

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

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

=== 2. 打包 ===

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

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

# <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 命令行
# 输入：<pre>brotli -q 5 dat文件 -o 输出的br文件</pre>示例：<pre>brotli -q 5 system.new.dat -o system.new.dat.br</pre>
# 小等一会，br文件将会被解压，解压后的文件在'''同目录'''

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

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

如何打包 Android ROM

2024-02-16T16:09:10Z

Iibchara-dev：/* 1. 获得所需工具 - mke2fs + e2fsdroid */

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

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

# [[#img格式打包|'''img格式''']]
# [[#dat格式打包|'''dat格式''']]
# [[#br格式打包|'''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] =====
<p style="color: gray;">访问工具链接并点击 '''下载图标''' 下载文件</p>

===== 2. 打包 =====
# 将工具放置到'''所需打包分区'''所在目录
# 在'''该目录'''下打开 cmd 命令行
# 记录 '''config\分区名_size.txt''' 内数值
# 输入：<pre>make_ext4fs.exe -J -T 1167580800 -S config\分区名_file_contexts -l 上一步记录的数值 -C config\分区名_fs_config -L 分区名 -a 分区名打包文件名分区文件夹名</pre>示例：<pre>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</pre>
# 小等一会将会打包完成

===== 注意 =====
* 打包要求您的文件需要'''严格按照解包后的结构'''（即'''所需打包文件夹 + config文件夹'''）存放，避免造成找不到文件的情况。如果您的机器是动态分区，请参考第二种打包方式
* 正确存放示例：<code>vendor config make_ext4fs.exe</code>

==== 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]

<p style="color: gray;">访问对应链接并点击 '''下载图标''' 下载文件</p>

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

<p style="color: gray;">访问 fspatch 仓库并点击 '''Code - Download zip''' 下载</p>

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

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

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

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

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

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

所需工具:
* mkfs.erofs - [https://github.com/sekaiacg/erofs-utils GitHub]
<p style="color: gray;">访问工具 GitHub 仓库并从 '''Release''' 内下载工具</p>
* fspatch - [https://github.com/affggh/fspatch GitHub]
<p style="color: gray;">访问 fspatch 仓库并点击 '''Code - Download zip''' 下载</p>

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

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

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

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

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

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

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

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

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

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

== dat格式打包 ==

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

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

=== 2. 打包 ===

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

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

# <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 命令行
# 输入：<pre>brotli -q 5 dat文件 -o 输出的br文件</pre>示例：<pre>brotli -q 5 system.new.dat -o system.new.dat.br</pre>
# 小等一会，br文件将会被解压，解压后的文件在'''同目录'''

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

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

如何打包 Android ROM

2024-02-16T16:06:57Z

Iibchara-dev：

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

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

# [[#img格式打包|'''img格式''']]
# [[#dat格式打包|'''dat格式''']]
# [[#br格式打包|'''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] =====
<p style="color: gray;">访问工具链接并点击 '''下载图标''' 下载文件</p>

===== 2. 打包 =====
# 将工具放置到'''所需打包分区'''所在目录
# 在'''该目录'''下打开 cmd 命令行
# 记录 '''config\分区名_size.txt''' 内数值
# 输入：<pre>make_ext4fs.exe -J -T 1167580800 -S config\分区名_file_contexts -l 上一步记录的数值 -C config\分区名_fs_config -L 分区名 -a 分区名打包文件名分区文件夹名</pre>示例：<pre>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</pre>
# 小等一会将会打包完成

===== 注意 =====
* 打包要求您的文件需要'''严格按照解包后的结构'''（即'''所需打包文件夹 + config文件夹'''）存放，避免造成找不到文件的情况。如果您的机器是动态分区，请参考第二种打包方式
* 正确存放示例：<code>vendor config make_ext4fs.exe</code>

==== 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 命令行
# 输入：<pre>python fspatch.py 分区文件夹名 config\分区名_fs_config</pre> 示例：<pre>python fspatch.py vendor config\vendor_fs_config</pre>
# 记录'''config\分区名_size.txt'''内数值，并除以'''4096'''后的数值 (例如: 11451419 / 4096)。如果有'''小数点'''（如 114514.19），请去除小数点并 '''+1'''（即 114515）
# 输入：<pre>mke2fs -O ^has_journal -L 分区名 -I 256 -M /分区名 -m 0 -t ext4 -b 4096 打包文件名上一步记录的数值</pre>示例：<pre>mke2fs -O ^has_journal -L vendor -I 256 -M /vendor -m 0 -t ext4 -b 4096 vendor_new.img 114515</pre>
# 输入：<pre>e2fsdroid -e -T 1167580800 -S 分区名_fs_config的绝对路径 -C 分区名_fs_config的绝对路径 -a /分区名 -f 分区文件夹名上一步输入的打包文件名</pre>示例：<pre>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</pre>
# 小等一会将会打包完成

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

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

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

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

所需工具:
* mkfs.erofs - [https://github.com/sekaiacg/erofs-utils GitHub]
<p style="color: gray;">访问工具 GitHub 仓库并从 '''Release''' 内下载工具</p>
* fspatch - [https://github.com/affggh/fspatch GitHub]
<p style="color: gray;">访问 fspatch 仓库并点击 '''Code - Download zip''' 下载</p>

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

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

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

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

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

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

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

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

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

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

== dat格式打包 ==

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

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

=== 2. 打包 ===

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

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

# <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 命令行
# 输入：<pre>brotli -q 5 dat文件 -o 输出的br文件</pre>示例：<pre>brotli -q 5 system.new.dat -o system.new.dat.br</pre>
# 小等一会，br文件将会被解压，解压后的文件在'''同目录'''

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

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

如何打包 Android ROM

2024-02-16T15:47:29Z

Iibchara-dev：

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

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

# [[#img格式打包|'''img格式''']]
# [[#dat格式打包|'''dat格式''']]
# [[#br格式打包|'''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] =====
<p style="color: gray;">访问工具链接并点击 '''下载图标''' 下载文件</p>

===== 2. 打包 =====
1. 将工具放置到'''所需打包分区'''所在目录

2. 在'''该目录'''下打开 cmd 命令行

3. 记录 '''config\分区名_size.txt''' 内数值

4. 输入：
<pre>make_ext4fs.exe -J -T 1167580800 -S config\分区名_file_contexts -l 上一步记录的数值 -C config\分区名_fs_config -L 分区名 -a 分区名打包文件名分区文件夹名</pre>

示例：

<pre>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</pre>

5. 小等一会将会打包完成

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

正确存放示例：<code>vendor config make_ext4fs.exe</code>

==== 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. 打包 =====

1. 将工具及运行库放置到'''所需打包分区'''所在目录

2. 在'''该目录'''下打开 cmd 命令行

3. 输入 <pre>python fspatch.py 分区文件夹名 config\分区名_fs_config</pre>
示例:
<pre>python fspatch.py vendor config\vendor_fs_config</pre>

4. 记录'''config\分区名_size.txt'''内数值，并除以'''4096'''后的数值 (例如: 11451419 / 4096)。如果有'''小数点'''（如 114514.19），请去除小数点并 '''+1'''（即 114515）

5. 输入：
<pre>mke2fs -O ^has_journal -L 分区名 -I 256 -M /分区名 -m 0 -t ext4 -b 4096 打包文件名上一步记录的数值</pre>
示例：
<pre>mke2fs -O ^has_journal -L vendor -I 256 -M /vendor -m 0 -t ext4 -b 4096 vendor_new.img 114515</pre>

6. 输入 <pre>e2fsdroid -e -T 1167580800 -S 分区名_fs_config的绝对路径 -C 分区名_fs_config的绝对路径 -a /分区名 -f 分区文件夹名上一步输入的打包文件名</pre>
示例：
<pre>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</pre>

7. 小等一会将会打包完成

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

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

=== 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. 打包 ====

1. 将工具内所有文件放置到'''所需打包分区'''所在目录

2. 在'''该目录'''下打开 cmd 命令行

3. 输入：
<pre>python fspatch.py 分区文件夹名 config\分区名_fs_config</pre>
示例：
<pre>python fspatch.py vendor config\vendor_fs_config</pre>

4. 输入：<pre>mkfs.erofs -zlz4hc,8 -T 1167580800 --mount-point=/分区名 --fs-config-file=分区名_fs_config的绝对路径 --file-contexts=分区名_file_contexts的绝对路径打包文件名分区文件夹名</pre>
示例：
<pre>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</pre>

5. 小等一会将会打包完成

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

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

=== 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，数字越大压缩率越高耗时越长

提取分区

2024-02-16T13:19:15Z

Iibchara-dev：/* 通过root权限提取 */

通常来说，Android有三种提取分区的方式:

* 从刷机包中提取
* 设备已获取root权限，通过root权限提取
* 通过MTK深刷/9008提取（不讨论）
* 大容量模式（不讨论）

=== 从刷机包中提取 ===
从刷机包中提取分区非常简单，对于zip格式的线刷包（其他格式自行寻找解包方法），只需要以压缩文件方式打开线刷包，解压需要提取的分区即可

如果是卡刷包，参考[[如何解包 Android ROM|这里]]提取分区

=== 通过root权限提取 ===
如果设备已经获取root权限，则可以通过root权限提取分区

'''注意:有些分区提取后可能并不支持直接通过fastboot刷入'''

有很多软件支持提取分区的功能，比如爱玩机工具箱，如果需要方便，可以试试这些软件

'''每个机型的提取方式可能不同，请自行在<code>/dev/block</code>下查看'''. 以红米5p举例，分区所在的内核节点路径在:

<code>/dev/block/bootdevice/by-name/分区名</code>

比如，若需要提取system分区，则分区所在的内核节点路径为:<code>/dev/block/bootdevice/by-name/system</code>

取得内核节点路径后，有两种方式提取分区:

# 通过cp指令: <code>cp 内核节点路径要提取到的文件路径</code>，例如<code>cp /dev/block/bootdevice/by-name/system /sdcard/system.img</code>，这会提取system分区到/sdcard/system.img
# 通过dd指令: <code>dd if=内核节点路径 of=要提取到的文件路径 bs=4M</code>，例如<code>dd if=/dev/block/bootdevice/by-name/system of=/sdcard/system.img bs=4M</code>，这同样会提取system分区到/sdcard/system.img，<code>bs=4M</code>意为将块大小指定为4M，由于储存器的特性，小于扇区大小会造成更多的寿命损失并增加读写时间。因此，为了加快速度并减少寿命损失，可使用类似于4M的整数. 对于较老的机型，可尝试转为字节，如<code>bs=4M</code>可换为<code>bs=4194304</code>

首页

2024-02-16T05:14:22Z

Iibchara-dev：/* 知名良心开发者 */

= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =

'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

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

== 进阶内容 ==
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[修改分区]]
# [[QCN]]
# [[Super_Empty]]

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

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

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

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[小白测评]]
# [[微积分WekiHome]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
# [[派大宝UI]]
# [[我可以等你十年]]
# [[某贼]]
# [[凡生TalkING]]

== 知名良心开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]

== 更多词条 ==
# [[设备代号收录集合]]
# [[通用系统镜像]]
# [[AOSP]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

页内跳转测试

2024-02-16T05:12:20Z

Iibchara-dev：

页内跳转测试

2024-02-16T05:11:15Z

Iibchara-dev：创建页面，内容为“<meta http-equiv="refresh" content="0;url=https://www.example.com">”

首页

2024-02-16T05:11:02Z

Iibchara-dev：/* 知名良心开发者 */

= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =

'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

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

== 进阶内容 ==
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[修改分区]]
# [[QCN]]
# [[Super_Empty]]

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

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

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

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[小白测评]]
# [[微积分WekiHome]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
# [[派大宝UI]]
# [[我可以等你十年]]
# [[某贼]]
# [[凡生TalkING]]

== 知名良心开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]
# [[页内跳转测试]]

== 更多词条 ==
# [[设备代号收录集合]]
# [[通用系统镜像]]
# [[AOSP]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

首页

2024-02-15T16:42:32Z

Iibchara-dev：

= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =

'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot驱动|ADB 与 Fastboot 驱动]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]

== 进阶内容 ==
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[修改分区]]
# [[QCN]]
# [[Super_Empty]]

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

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

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

== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[小白测评]]
# [[微积分WekiHome]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
# [[派大宝UI]]
# [[我可以等你十年]]
# [[某贼]]
# [[凡生TalkING]]

== 知名良心开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]

== 更多词条 ==
# [[设备代号收录集合]]
# [[通用系统镜像]]
# [[AOSP]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

ADB命令

2024-02-15T16:34:42Z

Iibchara-dev：

<h2>连接管理</h2>
列出所有连接设备及其序列号：
<pre>adb devices</pre>
如果有多个连接设备，则需要使用序列号来区分：
<pre>export ANDROID_SERIAL=<设备序列号></pre>
<pre>adb shell ls</pre>
多设备下连接指定设备
<pre>adb -s 序列号 shell</pre>
可以通过网络来连接 ADB：
让设备端的 adbd 重启，并在 TCP 端口 5555 处监听
<pre>adb tcpip 5555</pre>
此时可以断开 USB 连接
远程连接设备，设备的 IP 地址是 192.168.1.100
<pre>adb connect 192.168.1.100:5555</pre>
断开连接
<pre>adb disconnect 192.168.1.100:5555</pre>

<p style="color: gray;">注：在安卓11及以上版本中，可以直接在开发者选项中启用无线调试</p>

<h2>调试</h2>
<h4>获取系统日志</h4>
<pre>adb logcat</pre>
用法
<pre>adb logcat [选项] [应用标签]</pre>

<h5>示例</h5>
查看全部日志
<pre>adb logcat</pre>
仅查看部分日志
<pre>adb logcat -s WifiStateMachine StateMachine</pre>

<code>adb bugreport</code>用于错误报告，里面包含大量详细运行信息。

<h5>示例</h5>
<pre>adb bugreport</pre>
保存到本地，方便用编辑器查看
<pre>adb bugreport >bugreport.txt</pre>

<h2>root 权限</h2>
如果<code>TARGET_BUILD_VARIANT</code>使用的是 userdebug 模式，要获得 root 权限，需要先运行：
<pre>adb root</pre>
让 ADB 的设备端切换到 root 权限模式，这样 adb remount 等需要 root 权限的命令才会成功。
<p style="color: gray;">注：如果 TARGET_BUILD_VARIAN </code>使用的是 eng 模式，则 adb 默认为 root 权限不需要切换</p>

<h2>应用管理</h2>
<h4>安装应用</h4>
<pre>adb install</pre>

<h5>用法</h5>
<pre>adb install [选项] 应用包.apk</pre>
选项包括：

<strong>-l</strong> forward-lock

<strong>-r</strong> 重新安装应用，保留原先数据

<strong>-s</strong> 安装到 SD 卡上，而不是内部存储

<h5>示例</h5>
安装 facebook.apk
<pre>adb install facebook.apk</pre>
升级 twitter.apk
<pre>adb install -r twitter.apk</pre>
如果安装成功，工具会返回成功提示 <strong>Success</strong>；失败的话，一般是以下几种情况:

<strong>INSTALL_FAILED_ALREADY_EXISTS:</strong> 此时需要用 -r 参数来重新安装。

<strong>INSTALL_FAILED_SIGNATURE_ERROR:</strong> 应用的签名不一致，可能是发布版和调试版签名不同所致。

<strong>INSTALL_FAILED_INSUFFICIENT_STORAGE:</strong> 存储空间不足，需要检查设备存储情况。

<h4>卸载应用</h4>
<pre>adb uninstall</pre>
用法：
<pre>adb uninstall 应用包名称</pre>
示例：
<pre>adb uninstall com.android.chrome</pre>
应用包名称可以用以下命令列出：
<pre>adb shell pm list packages -f</pre>
运行结果是：
<pre>package:/system/app/Bluetooth.apk=com.android.bluetooth</pre>
前面是 apk 文件，后面则是对应的包名称。

ADB命令

2024-02-15T16:30:18Z

Iibchara-dev：

<h2>连接管理</h2>
列出所有连接设备及其序列号：
<pre>adb devices</pre>
如果有多个连接设备，则需要使用序列号来区分：
<pre>export ANDROID_SERIAL=<设备序列号></pre>
<pre>adb shell ls</pre>
多设备下连接指定设备
<pre>adb -s 序列号 shell</pre>
可以通过网络来连接 ADB：
让设备端的 adbd 重启，并在 TCP 端口 5555 处监听
<pre>adb tcpip 5555</pre>
此时可以断开 USB 连接
远程连接设备，设备的 IP 地址是 192.168.1.100
<pre>adb connect 192.168.1.100:5555</pre>
断开连接
<pre>adb disconnect 192.168.1.100:5555</pre>

<p style="color: gray;">注：在安卓11及以上版本中，可以直接在开发者选项中启用无线调试</p>

<h2>调试</h2>
<h4>获取系统日志</h4>
<pre>adb logcat</pre>
用法
<pre>adb logcat [选项] [应用标签]</pre>

<h5>示例</h5>
查看全部日志
<pre>adb logcat</pre>
仅查看部分日志
<pre>adb logcat -s WifiStateMachine StateMachine</pre>

<code>adb bugreport</code>用于错误报告，里面包含大量详细运行信息。

<h5>示例</h5>
<pre>adb bugreport</pre>
保存到本地，方便用编辑器查看
<pre>adb bugreport >bugreport.txt</pre>

<h2>root 权限</h2>
如果<code>TARGET_BUILD_VARIANT</code>使用的是 userdebug 模式，要获得 root 权限，需要先运行：
<pre>adb root</pre>
让 ADB 的设备端切换到 root 权限模式，这样 adb remount 等需要 root 权限的命令才会成功。

<h2>应用管理</h2>
<h4>安装应用</h4>
<pre>adb install</pre>

<h5>用法</h5>
<pre>adb install [选项] 应用包.apk</pre>
选项包括：

<strong>-l</strong> forward-lock

<strong>-r</strong> 重新安装应用，保留原先数据

<strong>-s</strong> 安装到 SD 卡上，而不是内部存储

<h5>示例</h5>
安装 facebook.apk
<pre>adb install facebook.apk</pre>
升级 twitter.apk
<pre>adb install -r twitter.apk</pre>
如果安装成功，工具会返回成功提示 <strong>Success</strong>；失败的话，一般是以下几种情况:

<strong>INSTALL_FAILED_ALREADY_EXISTS:</strong> 此时需要用 -r 参数来重新安装。

<strong>INSTALL_FAILED_SIGNATURE_ERROR:</strong> 应用的签名不一致，可能是发布版和调试版签名不同所致。

<strong>INSTALL_FAILED_INSUFFICIENT_STORAGE:</strong> 存储空间不足，需要检查设备存储情况。

<h4>卸载应用</h4>
<pre>adb uninstall</pre>
用法：
<pre>adb uninstall 应用包名称</pre>
示例：
<pre>adb uninstall com.android.chrome</pre>
应用包名称可以用以下命令列出：
<pre>adb shell pm list packages -f</pre>
运行结果是：
<pre>package:/system/app/Bluetooth.apk=com.android.bluetooth</pre>
前面是 apk 文件，后面则是对应的包名称。

ADB命令

2024-02-15T16:28:55Z

Iibchara-dev：

<h2>连接管理</h2>
列出所有连接设备及其序列号：
<pre>adb devices</pre>
如果有多个连接设备，则需要使用序列号来区分：
<pre>export ANDROID_SERIAL=<设备序列号></pre>
<pre>adb shell ls</pre>
多设备下连接指定设备
<pre>adb -s 序列号 shell</pre>
可以通过网络来连接 ADB：
让设备端的 adbd 重启，并在 TCP 端口 5555 处监听
<pre>adb tcpip 5555</pre>
此时可以断开 USB 连接
远程连接设备，设备的 IP 地址是 192.168.1.100
<pre>adb connect 192.168.1.100:5555</pre>
断开连接
<pre>adb disconnect 192.168.1.100:5555</pre>

<p style="color: gray;">注：在安卓11及以上版本中，可以直接在开发者选项中启用无线调试</p>

<h2>调试</h2>
<h4>获取系统日志</h4>
<pre>adb logcat</pre>
用法
<pre>adb logcat [选项] [应用标签]</pre>

<h5>示例</h5>
查看全部日志
<pre>adb logcat</pre>
仅查看部分日志
<pre>adb logcat -s WifiStateMachine StateMachine</pre>

<code>adb bugreport</code>用于错误报告，里面包含大量详细运行信息。

<h5>示例</h5>
<pre>adb bugreport</pre>
保存到本地，方便用编辑器查看
<pre>adb bugreport >bugreport.txt</pre>

<h2>root 权限</h2>
如果 TARGET_BUILD_VARIANT 使用的是 userdebug 模式，要获得 root 权限，需要先运行：
<pre>adb root</pre>
让 ADB 的设备端切换到 root 权限模式，这样 adb remount 等需要 root 权限的命令才会成功。

<h2>应用管理</h2>
<h4>安装应用</h4>
<pre>adb install</pre>

<h5>用法</h5>
<pre>adb install [选项] 应用包.apk</pre>
选项包括：

<strong>-l</strong> forward-lock

<strong>-r</strong> 重新安装应用，保留原先数据

<strong>-s</strong> 安装到 SD 卡上，而不是内部存储

<h5>示例</h5>
安装 facebook.apk
<pre>adb install facebook.apk</pre>
升级 twitter.apk
<pre>adb install -r twitter.apk</pre>
如果安装成功，工具会返回成功提示 <strong>Success</strong>；失败的话，一般是以下几种情况:

<strong>INSTALL_FAILED_ALREADY_EXISTS:</strong> 此时需要用 -r 参数来重新安装。

<strong>INSTALL_FAILED_SIGNATURE_ERROR:</strong> 应用的签名不一致，可能是发布版和调试版签名不同所致。

<strong>INSTALL_FAILED_INSUFFICIENT_STORAGE:</strong> 存储空间不足，需要检查设备存储情况。

<h4>卸载应用</h4>
<pre>adb uninstall</pre>
用法：
<pre>adb uninstall 应用包名称</pre>
示例：
<pre>adb uninstall com.android.chrome</pre>
应用包名称可以用以下命令列出：
<pre>adb shell pm list packages -f</pre>
运行结果是：
<pre>package:/system/app/Bluetooth.apk=com.android.bluetooth</pre>
前面是 apk 文件，后面则是对应的包名称。

ADB命令

2024-02-15T16:27:16Z

Iibchara-dev：

<h2>连接管理</h2>
列出所有连接设备及其序列号：
<pre>adb devices</pre>
如果有多个连接设备，则需要使用序列号来区分：
<pre>export ANDROID_SERIAL=<设备序列号></pre>
<pre>adb shell ls</pre>
多设备下连接指定设备
<pre>adb -s 序列号 shell</pre>
可以通过网络来连接 ADB：
让设备端的 adbd 重启，并在 TCP 端口 5555 处监听
<pre>adb tcpip 5555</pre>
此时可以断开 USB 连接
远程连接设备，设备的 IP 地址是 192.168.1.100
<pre>adb connect 192.168.1.100:5555</pre>
断开连接
<pre>adb disconnect 192.168.1.100:5555</pre>

<p style="color: gray;">注：在安卓11及以上版本中，可以直接在开发者选项中启用无线调试</p>

<h2>调试</h2>
<h4>获取系统日志</h4>
<pre>adb logcat</pre>
用法
<pre>adb logcat [选项] [应用标签]</pre>

<h5>示例</h5>
查看全部日志
<pre>adb logcat</pre>
仅查看部分日志
<pre>adb logcat -s WifiStateMachine StateMachine</pre>

<code>adb bugreport</code>用于错误报告，里面包含大量获取详细运行信息。

<h5>示例</h5>
<pre>adb bugreport</pre>
保存到本地，方便用编辑器查看
<pre>adb bugreport >bugreport.txt</pre>

<h2>root 权限</h2>
如果 TARGET_BUILD_VARIANT 使用的是 userdebug 模式，要获得 root 权限，需要先运行：
<pre>adb root</pre>
让 ADB 的设备端切换到 root 权限模式，这样 adb remount 等需要 root 权限的命令才会成功。

<h2>应用管理</h2>
<h4>安装应用</h4>
<pre>adb install</pre>

<h5>用法</h5>
<pre>adb install [选项] 应用包.apk</pre>
选项包括：

<strong>-l</strong> forward-lock

<strong>-r</strong> 重新安装应用，保留原先数据

<strong>-s</strong> 安装到 SD 卡上，而不是内部存储

<h5>示例</h5>
安装 facebook.apk
<pre>adb install facebook.apk</pre>
升级 twitter.apk
<pre>adb install -r twitter.apk</pre>
如果安装成功，工具会返回成功提示 <strong>Success</strong>；失败的话，一般是以下几种情况:

<strong>INSTALL_FAILED_ALREADY_EXISTS:</strong> 此时需要用 -r 参数来重新安装。

<strong>INSTALL_FAILED_SIGNATURE_ERROR:</strong> 应用的签名不一致，可能是发布版和调试版签名不同所致。

<strong>INSTALL_FAILED_INSUFFICIENT_STORAGE:</strong> 存储空间不足，需要检查设备存储情况。

<h4>卸载应用</h4>
<pre>adb uninstall</pre>
用法：
<pre>adb uninstall 应用包名称</pre>
示例：
<pre>adb uninstall com.android.chrome</pre>
应用包名称可以用以下命令列出：
<pre>adb shell pm list packages -f</pre>
运行结果是：
<pre>package:/system/app/Bluetooth.apk=com.android.bluetooth</pre>
前面是 apk 文件，后面则是对应的包名称。

首页

2024-02-15T15:26:32Z

Iibchara-dev：

[[文件:Uotan Wiki.png|缩略图]]
= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 11px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =

'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot驱动|ADB 与 Fastboot 驱动]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]

== 进阶内容 ==
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[修改分区]]
# [[QCN]]
# [[Super_Empty]]

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

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

== 高级内容 ==
# [[Android 分区详解]]
# [[GKI 内核]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[小白测评]]
# [[微积分WekiHome]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
# [[派大宝UI]]
# [[我可以等你十年]]
# [[某贼]]
# [[凡生TalkING]]

== 知名良心开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]

== 更多词条 ==
# [[设备代号收录集合]]
# [[通用系统镜像]]
# [[AOSP]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

首页

2024-02-15T15:23:04Z

Iibchara-dev：

[[文件:Uotan Wiki.png|缩略图]]
= 欢迎来到 <span style="display: inline-block; vertical-align: middle; padding-bottom: 12px;">[[文件:Uotan Wiki.png|120px]]</span> · 刷机百科 =

'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{NUMBEROFUSERS}}名用户，{{NUMBEROFEDITS}}次编辑，{{NUMBEROFARTICLES}}篇条目，{{NUMBEROFACTIVEUSERS}}位活跃编辑者。'''
== 刷机入门 ==
# [[ADB与Fastboot驱动|ADB 与 Fastboot 驱动]]
# [[解锁Bootloader|解锁 Bootloader]]
# [[刷入第三方Recovery|刷入第三方 Recovery]]
# [[获取Root权限|获取 Root 权限]]
# [[Miflash线刷|MiFlash 线刷]]

== 进阶内容 ==
# [[使用柚坛工具箱进行线刷]]
# [[ADB SideLoad]]
# [[Fastboot Update]]
# [[Fastboot 命令]]
# [[刷入任意单独镜像]]
# [[9008深度刷机|9008 深度刷机]]
# [[MTK Flashtool深度刷机|MTK Flashtool 深度刷机]]
# [[提取分区]]
# [[修改分区]]
# [[QCN]]
# [[Super_Empty]]

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

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

== 高级内容 ==
# [[Android 分区详解]]
# [[GKI 内核]]
# [[如何解包 Android ROM]]
# [[如何打包 Android ROM]]
# [[如何从源码构建 TWRP Recovery]]
# [[如何从源码构建 Android ROM]]
# [[使用edl.py|使用 edl.py]]
# [[为手机安装Linux|为手机安装 Linux]]
# [[Git使用教程]]
== 知名玩机博主 ==
# [[极客湾Geekerwan]]
# [[小白测评]]
# [[微积分WekiHome]]
# [[晨钟酱Official]]
# [[江灵夏草]]
# [[柚坛UOTAN]]
# [[派大宝UI]]
# [[我可以等你十年]]
# [[某贼]]
# [[凡生TalkING]]

== 知名良心开发者 ==
# [[暮间雾]]
# [[某贼]]
# [[Amktiao]]
# [[小太阳ACA]]
# [[hellobbn]]

== 更多词条 ==
# [[设备代号收录集合]]
# [[通用系统镜像]]
# [[AOSP]]
# [[Linux mainlining]]
# [[Windows on arm|WOA (Windows on arm)]]

首页

2024-02-15T15:22:47Z

Iibchara-dev：/* 欢迎来到 Uotan Wiki · 刷机百科 */

GKI

2024-02-15T15:06:43Z

Iibchara-dev：/* GKI内核与KMI接口 */

=== '''<big>前言</big>''' ===
随着Android系统的发展，碎片化问题对Android社区的生产影响越来越严重。

此前Android通过Project Treble等项目，将供应商驱动和系统解耦、将系统组件进行拆分，衍生出了system、system_ext、product、odm、vendor等分区，而gki内核项目就是Android在内核方面的解耦，使得内核的碎片化减少。

* 碎片化的危害：
* 安全更新需要耗费大量人力
* 很难合并长期支持的更新
* 妨碍 Android 平台进行版本升级
* 很难将内核更改贡献回上游 Linux

'''''具体细节请参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn 通用内核映像]'''''

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

'''''参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn#fragmentation-fix-gki 解决碎片化问题：通用内核映像]'''''

'''''小知识：不少手机厂商随着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>GKI内核与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-02-15T14:56:27Z

Iibchara-dev：/* GKI内核与KMI接口 */

=== '''<big>前言</big>''' ===
随着Android系统的发展，碎片化问题对Android社区的生产影响越来越严重。

此前Android通过Project Treble等项目，将供应商驱动和系统解耦、将系统组件进行拆分，衍生出了system、system_ext、product、odm、vendor等分区，而gki内核项目就是Android在内核方面的解耦，使得内核的碎片化减少。

* 碎片化的危害：
* 安全更新需要耗费大量人力
* 很难合并长期支持的更新
* 妨碍 Android 平台进行版本升级
* 很难将内核更改贡献回上游 Linux

'''''具体细节请参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn 通用内核映像]'''''

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

'''''参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn#fragmentation-fix-gki 解决碎片化问题：通用内核映像]'''''

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

具体来说，对 GKI 的设备，其内核版本格式应该如下：
<table>
<tr>
<th>KernelRelease :=</th>
</tr>
<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>-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-02-15T14:55:49Z

Iibchara-dev：/* GKI内核与KMI接口 */

=== '''<big>前言</big>''' ===
随着Android系统的发展，碎片化问题对Android社区的生产影响越来越严重。

此前Android通过Project Treble等项目，将供应商驱动和系统解耦、将系统组件进行拆分，衍生出了system、system_ext、product、odm、vendor等分区，而gki内核项目就是Android在内核方面的解耦，使得内核的碎片化减少。

* 碎片化的危害：
* 安全更新需要耗费大量人力
* 很难合并长期支持的更新
* 妨碍 Android 平台进行版本升级
* 很难将内核更改贡献回上游 Linux

'''''具体细节请参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn 通用内核映像]'''''

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

'''''参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn#fragmentation-fix-gki 解决碎片化问题：通用内核映像]'''''

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

具体来说，对 GKI 的设备，其内核版本格式应该如下：
<table>
<tr>
<th>KernelRelease :=</th>
</tr>
<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>-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>''' ===

Git使用教程

2024-02-15T14:29:04Z

Iibchara-dev：/* git status */

=== Git的由来： ===
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。

=== 常见的代码托管平台： ===
[https://github.com Github]

[https://gitlab.com Gitlab]

[https://gitee.com Gitee]

=== Git 常见命令: ===

==== git init ====
在本地目录中初始化一个新的Git仓库

==== git config ====
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。

<code>git config --global user.name "your username"</code><code>git config --global user.email "your email"</code>

==== git clone ====
用于将远程仓库的代码克隆到本地

<code><url></code>

克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台

<code>--depth=<number></code>

克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。

<code>-b <branch></code>

克隆指定分支下的仓库内容

==== git add ====
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中

添加一个或者多个文件到暂存区之中

<code>git add [file1] [file2]</code>

添加指定目录(文件)到暂存区，包括子目录：

添加当前目录下的所有文件到暂存区,包括子目录：

<code>git add [dir]</code>

添加当前目录下的所有文件到暂存区：

<code>git add .</code>

==== git status ====
查看当前仓库的状态，此时git会在你的终端输出以下内容
<p><em style="color: gray;">此处演示为英文，如果您的git终端输出为中文也是同理的</em></p>
<pre>
On branch master
No commits yet
Changes to be committed:

(use “git rm --cached <file>...” to unstage)
new file: makefile
</pre>

输出内容分别为

* 您目前所在的分支
* 目前的提交
* 需要更改的内容
* 新增文件
* 修改文件
* 删除文件

==== git commit ====
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）

提交暂存区的更改到本地仓库

<code>git commit -m "message"</code>

[注] message 可以是你的备注信息

提交暂存区中的指定文件到本地仓库

如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用

<code>git commit -a</code>

进行直接提交

==== git checkout ====

* 用于分支切换

切换分支：

<code>git checkout <branch-name></code>

<code>git checkout <branch-name></code>

例如在您的仓库中有这几个分支：<code>-> master</code>

<code>test</code>

您当前处于 master 分支，如果想要切换到test分支，我们可以使用

<code>git checkout test</code>

* 用于检出文件
将指定的文件恢复到最新的提交状态，撤销你对其的更改

<code>git checkout -- <file></code>
==== git push ====
用于将本地的分支版本上传到远程仓库并进行合并

<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code>

remote-host-name:远程主机名

local-branch-name:本地分支名

例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：

<code>git push origin master:master</code>

例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：

本地和远程分支名相同，上述命令可以简写为：

<code>git push origin master</code>

当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送

<code>git push --force origin master</code>

--force 此处可以直接简单化为 -f

如果你想要删除主机内的某个分支，你可以使用--delete参数

<code>git push origin --delete <branch-name></code>

==== git diff ====
用于比较当前工作区与上一个版本之间的差异

==== git log ====
用于查看提交的历史

例如当你进行一次提交之后，执行 <code>git log</code>终端会输出

<pre>
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)

Author: luluzzy <1054438588@qq.com>

Date: Thu Feb 15 21:28:47 2024 +0800

initial commit: add makefile
</pre>

这些输出分别为

* <strong>commit sha1 hash</strong>: 针对你这个提交的commit id

* <strong>Author</strong>: commit 作者名称 <you@example.com>
* <strong>Date</strong>: commit 日期
* <strong>commit</strong>: 名称
*
*
*

关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref>

当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅

此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称

例如

347595d (HEAD -> master) modify makefile

3a5b0d1 initial commit: add makefile

*

==== 参考资料： ====
[1] 百度百科-- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki>

[2] 菜鸟教程-- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki>

Git使用教程

2024-02-15T14:26:46Z

Iibchara-dev：/* git status */

=== Git的由来： ===
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。

=== 常见的代码托管平台： ===
[https://github.com Github]

[https://gitlab.com Gitlab]

[https://gitee.com Gitee]

=== Git 常见命令: ===

==== git init ====
在本地目录中初始化一个新的Git仓库

==== git config ====
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。

<code>git config --global user.name "your username"</code><code>git config --global user.email "your email"</code>

==== git clone ====
用于将远程仓库的代码克隆到本地

<code><url></code>

克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台

<code>--depth=<number></code>

克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。

<code>-b <branch></code>

克隆指定分支下的仓库内容

==== git add ====
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中

添加一个或者多个文件到暂存区之中

<code>git add [file1] [file2]</code>

添加指定目录(文件)到暂存区，包括子目录：

添加当前目录下的所有文件到暂存区,包括子目录：

<code>git add [dir]</code>

添加当前目录下的所有文件到暂存区：

<code>git add .</code>

==== git status ====
查看当前仓库的状态，此时git会在你的终端输出以下内容

(此处演示为英文，如果您的git终端输出为中文也是同理的)
<pre>
On branch master
No commits yet
Changes to be committed:

(use “git rm --cached <file>...” to unstage)
new file: makefile
</pre>

输出内容分别为

* 您目前所在的分支
* 目前的提交
* 需要更改的内容
* 新增文件
* 修改文件
* 删除文件

==== git commit ====
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）

提交暂存区的更改到本地仓库

<code>git commit -m "message"</code>

[注] message 可以是你的备注信息

提交暂存区中的指定文件到本地仓库

如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用

<code>git commit -a</code>

进行直接提交

==== git checkout ====

* 用于分支切换

切换分支：

<code>git checkout <branch-name></code>

<code>git checkout <branch-name></code>

例如在您的仓库中有这几个分支：<code>-> master</code>

<code>test</code>

您当前处于 master 分支，如果想要切换到test分支，我们可以使用

<code>git checkout test</code>

* 用于检出文件
将指定的文件恢复到最新的提交状态，撤销你对其的更改

<code>git checkout -- <file></code>
==== git push ====
用于将本地的分支版本上传到远程仓库并进行合并

<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code>

remote-host-name:远程主机名

local-branch-name:本地分支名

例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：

<code>git push origin master:master</code>

例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：

本地和远程分支名相同，上述命令可以简写为：

<code>git push origin master</code>

当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送

<code>git push --force origin master</code>

--force 此处可以直接简单化为 -f

如果你想要删除主机内的某个分支，你可以使用--delete参数

<code>git push origin --delete <branch-name></code>

==== git diff ====
用于比较当前工作区与上一个版本之间的差异

==== git log ====
用于查看提交的历史

例如当你进行一次提交之后，执行 <code>git log</code>终端会输出

<pre>
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)

Author: luluzzy <1054438588@qq.com>

Date: Thu Feb 15 21:28:47 2024 +0800

initial commit: add makefile
</pre>

这些输出分别为

* <strong>commit sha1 hash</strong>: 针对你这个提交的commit id

* <strong>Author</strong>: commit 作者名称 <you@example.com>
* <strong>Date</strong>: commit 日期
* <strong>commit</strong>: 名称
*
*
*

关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref>

当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅

此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称

例如

347595d (HEAD -> master) modify makefile

3a5b0d1 initial commit: add makefile

*

==== 参考资料： ====
[1] 百度百科-- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki>

[2] 菜鸟教程-- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki>

Git使用教程

2024-02-15T14:22:30Z

Iibchara-dev：/* git log */

=== Git的由来： ===
Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理，也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper。

=== 常见的代码托管平台： ===
[https://github.com Github]

[https://gitlab.com Gitlab]

[https://gitee.com Gitee]

=== Git 常见命令: ===

==== git init ====
在本地目录中初始化一个新的Git仓库

==== git config ====
用于配置用户的信息以及其他设置,在使用git之前您必须完成以下步骤。

<code>git config --global user.name "your username"</code><code>git config --global user.email "your email"</code>

==== git clone ====
用于将远程仓库的代码克隆到本地

<code><url></code>

克隆某个地址(url)的仓库，远程仓库的地址可以是本地的目录，也可以是例如github,giteee,gitlab一类的代码托管平台

<code>--depth=<number></code>

克隆仓库并且保留number条提交历史，number在此处即表达我们克隆的深度。

<code>-b <branch></code>

克隆指定分支下的仓库内容

==== git add ====
添加某个文件，或者目录到暂存区，用于告诉git你需要将哪些文件的更改包含在下一次的提交(commit)之中

添加一个或者多个文件到暂存区之中

<code>git add [file1] [file2]</code>

添加指定目录(文件)到暂存区，包括子目录：

添加当前目录下的所有文件到暂存区,包括子目录：

<code>git add [dir]</code>

添加当前目录下的所有文件到暂存区：

<code>git add .</code>

==== git status ====
查看当前仓库的状态，此时git会在你的终端输出以下内容

(此处演示为英文，如果您的git终端输出为中文也是同理的)

<code>On branch master</code>

<code>No commits yet</code>

<code>Changes to be committed: </code>

<code>(use “git rm --cached <file>...” to unstage) </code>

<code>new file: makefile</code>

输出内容分别为

* 您目前所在的分支
* 目前的提交
* 需要更改的内容
* 新增文件
* 修改文件
* 删除文件

==== git commit ====
用于将暂存区我们保存的更改文件添加到本地仓库，并且会生成一条提交（commit）

提交暂存区的更改到本地仓库

<code>git commit -m "message"</code>

[注] message 可以是你的备注信息

提交暂存区中的指定文件到本地仓库

如果你没有使用上述<code>git add</code>命令暂存你的修改文件，可以使用

<code>git commit -a</code>

进行直接提交

==== git checkout ====

* 用于分支切换

切换分支：

<code>git checkout <branch-name></code>

<code>git checkout <branch-name></code>

例如在您的仓库中有这几个分支：<code>-> master</code>

<code>test</code>

您当前处于 master 分支，如果想要切换到test分支，我们可以使用

<code>git checkout test</code>

* 用于检出文件
将指定的文件恢复到最新的提交状态，撤销你对其的更改

<code>git checkout -- <file></code>
==== git push ====
用于将本地的分支版本上传到远程仓库并进行合并

<code>git push <remote-host-name> <local-branch-name>:<remote-branch-name></code>

remote-host-name:远程主机名

local-branch-name:本地分支名

例如，当你的远程主机名为origin ，本地分支名为master，远程分支名为master时：

<code>git push origin master:master</code>

例如，当你的rhost名为origin 本地分支名为master远程分支名为master时：

本地和远程分支名相同，上述命令可以简写为：

<code>git push origin master</code>

当你的远程版本与本地版本有差异，无法直接push时，你可以使用--force 参数来进行强制推送

<code>git push --force origin master</code>

--force 此处可以直接简单化为 -f

如果你想要删除主机内的某个分支，你可以使用--delete参数

<code>git push origin --delete <branch-name></code>

==== git diff ====
用于比较当前工作区与上一个版本之间的差异

==== git log ====
用于查看提交的历史

例如当你进行一次提交之后，执行 <code>git log</code>终端会输出

<pre>
commit 3a5b0d12f471418b13f2baf5e9e4c112a5e804a8 (HEAD -> master)

Author: luluzzy <1054438588@qq.com>

Date: Thu Feb 15 21:28:47 2024 +0800

initial commit: add makefile
</pre>

这些输出分别为

* <strong>commit sha1 hash</strong>: 针对你这个提交的commit id

* <strong>Author</strong>: commit 作者名称 <you@example.com>
* <strong>Date</strong>: commit 日期
* <strong>commit</strong>: 名称
*
*
*

关于sha1_hash的介绍请看这里<ref>生成这个hash值，它是对那个commit是Git仓库中内容和头信息Header的一个校验和checksum。Linux kernel开创者和Git的开发者——Linus说，Git使用了sha1并非是为了安全性，而是为了数据的完整性；它可以保证，在很多年后，你重新checkout某个commit时，一定是它多年前的当时的状态，完全一摸一样，完全值得信任。在Git中，根据commit的sha1值40个十六进制数字进行了简单的划分目录，以前2位数字作为目录名，其下面是剩余38位数字组成的一个文件名</ref>

当有多次提交之后，如果我们想要翻之前的提交历史，难免会因为终端输出的内容过多而难以查看翻阅

此时我们可以使用<code>--online</code>参数来简化输出，此时仅会输出: sha1哈希值 + commit的名称

例如

347595d (HEAD -> master) modify makefile

3a5b0d1 initial commit: add makefile

*

==== 参考资料： ====
[1] 百度百科-- Git：<nowiki>https://baike.baidu.com/item/GIT/12647237?fr=ge_ala</nowiki>

[2] 菜鸟教程-- Git基本操作：<nowiki>https://www.runoob.com/git/git-basic-operations.html</nowiki>

GKI

2024-02-15T14:16:59Z

Iibchara-dev：/* GKI内核与KMI接口 */

=== '''<big>前言</big>''' ===
随着Android系统的发展，碎片化问题对Android社区的生产影响越来越严重。

此前Android通过Project Treble等项目，将供应商驱动和系统解耦、将系统组件进行拆分，衍生出了system、system_ext、product、odm、vendor等分区，而gki内核项目就是Android在内核方面的解耦，使得内核的碎片化减少。

* 碎片化的危害：
* 安全更新需要耗费大量人力
* 很难合并长期支持的更新
* 妨碍 Android 平台进行版本升级
* 很难将内核更改贡献回上游 Linux

'''''具体细节请参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn 通用内核映像]'''''

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

'''''参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn#fragmentation-fix-gki 解决碎片化问题：通用内核映像]'''''

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

具体来说，对 GKI 的设备，其内核版本格式应该如下：
<table>
<tr>
<th>KernelRelease :=</th>
</tr>
<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>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-02-15T14:15:05Z

Iibchara-dev：

=== '''<big>前言</big>''' ===
随着Android系统的发展，碎片化问题对Android社区的生产影响越来越严重。

此前Android通过Project Treble等项目，将供应商驱动和系统解耦、将系统组件进行拆分，衍生出了system、system_ext、product、odm、vendor等分区，而gki内核项目就是Android在内核方面的解耦，使得内核的碎片化减少。

* 碎片化的危害：
* 安全更新需要耗费大量人力
* 很难合并长期支持的更新
* 妨碍 Android 平台进行版本升级
* 很难将内核更改贡献回上游 Linux

'''''具体细节请参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn 通用内核映像]'''''

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

'''''参考：[https://source.android.google.cn/docs/core/architecture/kernel/generic-kernel-image?hl=zh-cn#fragmentation-fix-gki 解决碎片化问题：通用内核映像]'''''

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

具体来说，对 GKI 的设备，其内核版本格式应该如下：
<table>
<tr>
<th>KernelRelease :=</th>
</tr>
<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>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>''' ===