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

获取Root权限

2024-12-02T13:45:24Z

InnoSofts-Bit：添加Root权限获取建议，以及解释应用如何获得Root权限

== 首先了解一下Android系统中Root权限的概念 ==
同Linux相似，Android系统中的Root权限是Android系统中的最高权限，可以完成绝大部分需要高权限的操作

'''<big>因此，获取Root权限后，应妥善管理，不应给可疑软件Root权限，更不应随意使用Root权限修改系统文件，因Root权限管理/使用不当导致的问题，轻则系统出现bug，重则变砖！</big>'''

'''<big>我们在此提倡正确使用Root权限，获取Root权限的初心应当是获得更高的自由度或其他因素</big>'''

'''<big>我们不支持仅为了开挂而获取Root权限的行为</big>'''

=== <big>操作前准备</big> ===

* 设备Bootloader已解锁
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

=== <big>正式操作</big> ===
'''<big>目前有三种主流的Root方案:[[Magisk|Magisk（面具）]] [[KernelSU]] 与 [[APatch]]</big>'''

Magisk是建议的root方案，它比较简单，适用于入门用户

KernelSU较为高级，且兼容的内核版本没有Magisk广泛，但KernelSU在内核层面提供root，反检测能力更强，适用于高级用户

APatch是内核层面的root，但提供了Magisk的修补功能

'''<big>强烈建议：在刷入Magisk,KernelSU或APatch前备份boot镜像，供无法开机时恢复</big>'''

=== '''<big>---------- 1.使用Magisk ----------</big>''' ===

=== 方案一:提取boot并刷入（较稳定） ===

==== 1.获取设备的boot镜像 ====
获取boot镜像的一般方式是从刷机包中提取

'''注:如果设备的内核版本为5.15.XX – 6.1.XX，且内核版本中含有"android13"或更高android版本的字符串，请提取init_boot.img而不是boot.img，此时下文的"boot镜像"指的是init_boot.img;否则提取boot.img即可'''

从官方网站/其他途径下载该设备的（认真核对，设备代号必须一致），系统版本一致的卡刷包/线刷包

'''如果获取的刷机包不是zip格式，请自行在网上寻找解包方法'''

以压缩文件方式打开刷机包，一般会有两种情况:

1.可以直接看到boot.img/init_boot.img，提取即可

2.没有boot.img/init_boot.img，但是有payload.bin，请参考Magisk中文网的[https://magiskcn.com/payload-dumper-go-boot 教程]提取出boot镜像

==== 2.使用Magisk修补boot镜像 ====

===== 方法一：APP修补 =====
1.将提取的boot镜像传到设备上，在设备上下载并安装Magisk，点击主页"Magisk"卡片右上角的"安装"

2.Magisk可能会提供一些选项，若无特殊需求则直接点击"下一步"，若没有则忽略

3.点击"选择并修补一个文件"，选择提取的boot镜像，点击"开始"，等待

4.依照Magisk输出中给出的修补后的镜像路径，将修补后的镜像传给电脑

'''注：有些机型支持使用fastboot boot boot镜像路径的方式来临时启动boot镜像，如果magisk正常工作，再使用刷入命令刷入'''

'''这样的好处在于，如果magisk没有正常工作，可以直接重启来恢复，建议优先使用该方法'''

5.手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

fastboot flash boot 修补后的boot镜像路径

如果设备为AB分区，请附加槽位后缀，默认为当前活动槽位

（如果设备刷入了第三方Recovery，可忽略第4步和第5步，直接在Recovery中刷入镜像）

不出意外，fastboot应该刷入成功，重启设备，设备应该正常开机，Magisk正常工作

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

若不能正常工作，请刷回原来的boot镜像，使用该指令:

fastboot flash boot boot镜像路径

===== 方法二：使用柚坛工具箱修补 =====
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|630x630像素]]
在柚坛工具箱的基本刷入页面的修补Boot中，选择提取出的Boot镜像，在选择文件一行中，可以更换需要使用的Magisk安装包，不更换则自动使用工具箱默认的版本。一般情况下，下面的5个选项保持默认即可。随后，点击开始修补。

修补完成后工具箱会提示是否刷入至当前设备，选择是即可刷入至当前连接的设备（请确保设备处于Fastboot模式），选择否将自动打开修补后的boot所在的文件夹。

=== 方案二：使用第三方Recovery卡刷 ===
这种方法更简便，尤其是设备刷入了第三方Recovery，而boot镜像的获取比较困难之时，可选择直接卡刷

这种方案仅需要:

# 获取Magisk安装包并安装，但是不要删除安装包
# 在第三方Recovery中直接安装该Magisk安装包.如果Recovery的刷入界面中找不到Magisk安装包，请在文件管理中把安装包的后缀改为.zip
# 重启.不出意外，Magisk正常工作

如果Magisk没有正常工作，请使用Recovery或电脑刷入备份的boot镜像

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

=== '''---------- 2.使用KernelSU ----------''' ===
'''注:使用KernelSU获取Root权限相对于Magisk复杂一点，且部分Magisk模块可能不兼容KernelSU，请谨慎选择'''

==== <big>操作前准备</big> ====

* 设备Bootloader已解锁
* 设备使用的是gki内核（不知道什么是gki内核没关系，可使用KernelSU管理器查看，见下文）
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

==== <big>正式操作</big> ====

==== 1.检查支持 ====
从[https://github.com/tiann/KernelSU/releases KernelSU GitHub Release]下载KernelSU管理器（文件名为xxx.apk，建议最新版本）后安装并打开

如果KernelSU显示的是"不支持"，则表明KernelSU不支持该设备，这很大概率上是因为设备内核非gki内核

你可以尝试自己编译内核，但这不是本章节讨论的内容

如果KernelSU显示的是"未安装"，则表明设备支持KernelSU，可以进行下一步操作

==== 2.获取内核并刷入 ====
'''<big>强烈建议：在刷入KernelSU前备份设备boot镜像，以供无法启动时恢复</big>'''

===== 方案一：手动处理 =====

====== 方法一：GKI ======
首先查看你的内核版本，看完下文gki内核版本概述，并在[https://github.com/tiann/KernelSU/releases KernelSU GitHub Release]获取正确的boot镜像

gki内核的内核版本大致的组成是这样的:

<code>内核大版本.patchlevel.sublevel-内核android版本-KmiGeneration-其他</code>

比如一个内核的内核版本为<code>5.10.335-android13-9-g12345678</code>

那么，该内核的'''内核大版本'''为5，'''patchlevel'''为10，'''sublevel'''为335，'''内核android版本'''为13，'''KmiGeneration'''为9，g12345678为其他部分

刷入的boot镜像中 '''内核大版本'''，'''patchlevel'''，'''内核android版本'''和'''KmiGeneration'''必须一致，'''理论上'''sublevel不一致也能开机

boot镜像的内核压缩方式也需要注意，不同机型有不同的压缩方式，一般是'''lz4'''和'''gzip'''，小米设备主要是gzip

'''如何确定压缩方式?'''

参考[[Magiskboot|这里]]解包boot

并查看输出的<code>KERNEL_FMT</code>即为内核压缩方式

同样需要注意'''Android安全补丁级别'''，最好刷入'''Android安全补丁级别'''一致的boot镜像，否则可能会不开机

在KernelSU github release中获取'''内核android版本'''，'''内核大版本'''，'''patchlevel'''，'''Android安全补丁级别'''，'''内核压缩方式'''一致的boot镜像

（最好sublevel也一致）

'''<big>下面开始刷入boot镜像</big>'''

'''注：建议先临时启动boot镜像，若无问题再进行刷入;指令:
fastboot boot boot镜像路径

'''如果设备刷入了第三方Recovery，可以使用Recovery进行刷入镜像操作'''

手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

fastboot flash boot boot镜像路径

如果设备为AB分区，请附加槽位后缀，默认为当前活动槽位

不出意外，fastboot应该刷入成功. 重启设备，若成功进入系统，且KernelSU管理器显示"工作中"，则刷入成功

如果KernelSU没有正常工作，使用如下指令刷入备份的boot镜像来恢复:

fastboot flash boot 备份的原boot镜像路径

====== 方法二：LKM（较为简便） ======
KernelSU现在对于GKI内核提供LKM安装方法，实现了与Magisk相似的修补功能

LKM的优点在于不需要刷入GKI内核，仅让KernelSU作为一个内核模块加入到内核，较为便捷

方法:

# 打开KernelSU管理器，点击"未安装"红色卡片
# 无特殊需求则选择"选择并修补一个文件"
# 选择设备当前的boot镜像
# 等待修补完成，然后刷入修补后的boot重启即可（刷入参见上文）

注意，KernelSU拒绝修补已经被Magisk修补后的boot镜像

===== 方案二：使用柚坛工具箱实现KernelSU =====
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|702x702像素]]
在柚坛工具的基本刷入的修补Boot部分中，可以在选择文件中选择[https://github.com/tiann/KernelSU/releases KernelSU github release]提供的AnyKernel文件或KO文件*，随后在选择Boot 中选择提取出的Boot文件，随后点击开始修补。

修补完成后工具箱会提示是否刷入至当前设备，选择是即可刷入至当前连接的设备（请确保设备处于Fastboot模式），选择否将自动打开修补后的boot所在的文件夹。

<nowiki>*</nowiki>3.0版本的柚坛工具箱暂不支持选择KO文件，该功能将于3.1版本支持。

=== ---------- 3.使用APatch ---------- ===
可以从[[APatch|这里]]了解APatch

使用方法:

# 从[https://github.com/bmax121/APatch/releases Github]下载APatch管理器并打开
# 点击"安装"，输入一个Root密钥（Root密钥是用APatch获取Root权限的必要数据，丢失会导致无法使用Root权限，请妥善保管）
# 选择当前的设备boot镜像，有需要可嵌入模块
# 修补，刷入（刷入见上文）
# 打开APatch，输入Root密钥，安装系统补丁

如果你的boot镜像修补失败，很大概率是因为内核未启用完整的kallsyms支持(CONFIG_KALLSYMS_ALL）

=== 应用如何请求root权限 ===
一般地，应用通过调用二进制文件su来请求root权限

如果自定义了su路径，那么需要为app手动指定su路径

如果你想在终端中获取root权限，可以直接输入su调用su二进制文件，或使用自定义su路径

获取Root权限

2024-08-18T13:42:20Z

InnoSofts-Bit：更改magiskboot 引用到词条

== 首先了解一下Android系统中Root权限的概念 ==
同Linux相似，Android系统中的Root权限是Android系统中的最高权限，可以完成绝大部分需要高权限的操作

'''<big>因此，获取Root权限后，应妥善管理，不应给可疑软件Root权限，更不应随意使用Root权限修改系统文件，因Root权限管理/使用不当导致的问题，轻则系统出现bug，重则变砖！</big>'''

=== <big>操作前准备</big> ===

* 设备Bootloader已解锁
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

=== <big>正式操作</big> ===
'''<big>目前有三种主流的Root方案:[[Magisk|Magisk（面具）]] [[KernelSU]] 与 [[APatch]]</big>'''

Magisk是建议的root方案，它比较简单，适用于入门用户

KernelSU较为高级，且兼容的内核版本没有Magisk广泛，但KernelSU在内核层面提供root，反检测能力更强，适用于高级用户

APatch是内核层面的root，但提供了Magisk的修补功能

'''<big>强烈建议：在刷入Magisk,KernelSU或APatch前备份boot镜像，供无法开机时恢复</big>'''

=== '''<big>---------- 1.使用Magisk ----------</big>''' ===

=== 方案一:提取boot并刷入（较稳定） ===

==== 1.获取设备的boot镜像 ====
获取boot镜像的一般方式是从刷机包中提取

'''注:如果设备的内核版本为5.15.XX – 6.1.XX，且内核版本中含有"android13"或更高android版本的字符串，请提取init_boot.img而不是boot.img，此时下文的"boot镜像"指的是init_boot.img;否则提取boot.img即可'''

从官方网站/其他途径下载该设备的（认真核对，设备代号必须一致），系统版本一致的卡刷包/线刷包

'''如果获取的刷机包不是zip格式，请自行在网上寻找解包方法'''

以压缩文件方式打开刷机包，一般会有两种情况:

1.可以直接看到boot.img/init_boot.img，提取即可

2.没有boot.img/init_boot.img，但是有payload.bin，请参考Magisk中文网的[https://magiskcn.com/payload-dumper-go-boot 教程]提取出boot镜像

==== 2.使用Magisk修补boot镜像 ====

===== 方法一：APP修补 =====
1.将提取的boot镜像传到设备上，在设备上下载并安装Magisk，点击主页"Magisk"卡片右上角的"安装"

2.Magisk可能会提供一些选项，若无特殊需求则直接点击"下一步"，若没有则忽略

3.点击"选择并修补一个文件"，选择提取的boot镜像，点击"开始"，等待

4.依照Magisk输出中给出的修补后的镜像路径，将修补后的镜像传给电脑

'''注：有些机型支持使用fastboot boot boot镜像路径的方式来临时启动boot镜像，如果magisk正常工作，再使用刷入命令刷入'''

'''这样的好处在于，如果magisk没有正常工作，可以直接重启来恢复，建议优先使用该方法'''

5.手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

fastboot flash boot 修补后的boot镜像路径

如果设备为AB分区，请附加槽位后缀，默认为当前活动槽位

（如果设备刷入了第三方Recovery，可忽略第4步和第5步，直接在Recovery中刷入镜像）

不出意外，fastboot应该刷入成功，重启设备，设备应该正常开机，Magisk正常工作

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

若不能正常工作，请刷回原来的boot镜像，使用该指令:

fastboot flash boot boot镜像路径

===== 方法二：使用柚坛工具箱修补 =====
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|630x630像素]]
在柚坛工具箱的基本刷入页面的修补Boot中，选择提取出的Boot镜像，在选择文件一行中，可以更换需要使用的Magisk安装包，不更换则自动使用工具箱默认的版本。一般情况下，下面的5个选项保持默认即可。随后，点击开始修补。

修补完成后工具箱会提示是否刷入至当前设备，选择是即可刷入至当前连接的设备（请确保设备处于Fastboot模式），选择否将自动打开修补后的boot所在的文件夹。

=== 方案二：使用第三方Recovery卡刷 ===
这种方法更简便，尤其是设备刷入了第三方Recovery，而boot镜像的获取比较困难之时，可选择直接卡刷

这种方案仅需要:

# 获取Magisk安装包并安装，但是不要删除安装包
# 在第三方Recovery中直接安装该Magisk安装包.如果Recovery的刷入界面中找不到Magisk安装包，请在文件管理中把安装包的后缀改为.zip
# 重启.不出意外，Magisk正常工作

如果Magisk没有正常工作，请使用Recovery或电脑刷入备份的boot镜像

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

=== '''---------- 2.使用KernelSU ----------''' ===
'''注:使用KernelSU获取Root权限相对于Magisk复杂一点，且部分Magisk模块可能不兼容KernelSU，请谨慎选择'''

==== <big>操作前准备</big> ====

* 设备Bootloader已解锁
* 设备使用的是gki内核（不知道什么是gki内核没关系，可使用KernelSU管理器查看，见下文）
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

==== <big>正式操作</big> ====

==== 1.检查支持 ====
从[https://github.com/tiann/KernelSU/releases KernelSU GitHub Release]下载KernelSU管理器（文件名为xxx.apk，建议最新版本）后安装并打开

如果KernelSU显示的是"不支持"，则表明KernelSU不支持该设备，这很大概率上是因为设备内核非gki内核

你可以尝试自己编译内核，但这不是本章节讨论的内容

如果KernelSU显示的是"未安装"，则表明设备支持KernelSU，可以进行下一步操作

==== 2.获取内核并刷入 ====
'''<big>强烈建议：在刷入KernelSU前备份设备boot镜像，以供无法启动时恢复</big>'''

===== 方案一：手动处理 =====

====== 方法一：GKI ======
首先查看你的内核版本，看完下文gki内核版本概述，并在[https://github.com/tiann/KernelSU/releases KernelSU GitHub Release]获取正确的boot镜像

gki内核的内核版本大致的组成是这样的:

<code>内核大版本.patchlevel.sublevel-内核android版本-KmiGeneration-其他</code>

比如一个内核的内核版本为<code>5.10.335-android13-9-g12345678</code>

那么，该内核的'''内核大版本'''为5，'''patchlevel'''为10，'''sublevel'''为335，'''内核android版本'''为13，'''KmiGeneration'''为9，g12345678为其他部分

刷入的boot镜像中 '''内核大版本'''，'''patchlevel'''，'''内核android版本'''和'''KmiGeneration'''必须一致，'''理论上'''sublevel不一致也能开机

boot镜像的内核压缩方式也需要注意，不同机型有不同的压缩方式，一般是'''lz4'''和'''gzip'''，小米设备主要是gzip

'''如何确定压缩方式?'''

参考[[Magiskboot|这里]]解包boot

并查看输出的<code>KERNEL_FMT</code>即为内核压缩方式

同样需要注意'''Android安全补丁级别'''，最好刷入'''Android安全补丁级别'''一致的boot镜像，否则可能会不开机

在KernelSU github release中获取'''内核android版本'''，'''内核大版本'''，'''patchlevel'''，'''Android安全补丁级别'''，'''内核压缩方式'''一致的boot镜像

（最好sublevel也一致）

'''<big>下面开始刷入boot镜像</big>'''

'''注：建议先临时启动boot镜像，若无问题再进行刷入;指令:
fastboot boot boot镜像路径

'''如果设备刷入了第三方Recovery，可以使用Recovery进行刷入镜像操作'''

手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

fastboot flash boot boot镜像路径

如果设备为AB分区，请附加槽位后缀，默认为当前活动槽位

不出意外，fastboot应该刷入成功. 重启设备，若成功进入系统，且KernelSU管理器显示"工作中"，则刷入成功

如果KernelSU没有正常工作，使用如下指令刷入备份的boot镜像来恢复:

fastboot flash boot 备份的原boot镜像路径

====== 方法二：LKM（较为简便） ======
KernelSU现在对于GKI内核提供LKM安装方法，实现了与Magisk相似的修补功能

LKM的优点在于不需要刷入GKI内核，仅让KernelSU作为一个内核模块加入到内核，较为便捷

方法:

# 打开KernelSU管理器，点击"未安装"红色卡片
# 无特殊需求则选择"选择并修补一个文件"
# 选择设备当前的boot镜像
# 等待修补完成，然后刷入修补后的boot重启即可（刷入参见上文）

注意，KernelSU拒绝修补已经被Magisk修补后的boot镜像

===== 方案二：使用柚坛工具箱实现KernelSU =====
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|702x702像素]]
在柚坛工具的基本刷入的修补Boot部分中，可以在选择文件中选择[https://github.com/tiann/KernelSU/releases KernelSU github release]提供的AnyKernel文件或KO文件*，随后在选择Boot 中选择提取出的Boot文件，随后点击开始修补。

修补完成后工具箱会提示是否刷入至当前设备，选择是即可刷入至当前连接的设备（请确保设备处于Fastboot模式），选择否将自动打开修补后的boot所在的文件夹。

<nowiki>*</nowiki>3.0版本的柚坛工具箱暂不支持选择KO文件，该功能将于3.1版本支持。

=== ---------- 3.使用APatch ---------- ===
可以从[[APatch|这里]]了解APatch

使用方法:

# 从[https://github.com/bmax121/APatch/releases Github]下载APatch管理器并打开
# 点击"安装"，输入一个Root密钥（Root密钥是用APatch获取Root权限的必要数据，丢失会导致无法使用Root权限，请妥善保管）
# 选择当前的设备boot镜像，有需要可嵌入模块
# 修补，刷入（刷入见上文）
# 打开APatch，输入Root密钥，安装系统补丁

如果你的boot镜像修补失败，很大概率是因为内核未启用完整的kallsyms支持(CONFIG_KALLSYMS_ALL）

Magiskboot

2024-08-18T13:40:59Z

InnoSofts-Bit：补全词条 magiskboot

== 什么是Magiskboot ==
magiskboot是magisk提供的一个解包boot/recovery的工具，magisk通过magiskboot来解包boot

相对于其他解包工具（如AIK）而言，magiskboot的拆分较为简单

你可以从[https://mrzzoxo.lanzoui.com/b02r7q0dg 来自KernelSU中文网的链接]下载magiskboot

== 用法 ==
输入magiskboot可直接查看用法

'''注意，下文用法中，带<尖括号>的为必需参数，带[中括号]的为可选参数，传入参数时不要带上括号'''

=== 解包 ===

<pre>magiskboot unpack [-n] [-h] 镜像路径</pre>

解包镜像

这将会把镜像解包成以下几个部分（如果有的话）:<code>kernel</code>, <code>kernel_dtb</code>, <code>ramdisk.cpio</code>, <code>second</code>, <code>dtb</code>, <code>extra</code>, <code>recovery_dtbo</code>

若指定<code>-n</code>参数，则每个部分都不会解压缩，保留原数据（如kernel会变成原有的压缩格式而不解压）

若指定<code>-h</code>参数，则镜像头会被单独dump出来成为一个文件header，里面记录了<code>cmdline</code>，<code>android版本</code>和<code>android补丁</code>级别等数据

可以查看程序输出以获得镜像的相关信息，如内核压缩方式等

注意，即使指定了-h参数，打包时仍然需要传入原boot镜像路径

程序返回值: 0:成功 1:错误 2:镜像来源为chromeos

=== 打包 ===
<pre>magiskboot repack [-n] <原镜像路径> [输出镜像路径]</pre>

将解包出的数据重新打包成镜像

magiskboot将会从传入的boot路径读取相关信息（如cmdline）并打包

若不指定输出boot路径，则输出到当前目录下的<code>new-boot.img</code>

若指定<code>-n</code>参数，则数据将不经过压缩操作就直接打包

若unpack时未指定-n参数，则repack时也不应指定，反之亦然

若在环境变量中设置<code>PATCHVBMETAFLAG</code>为true，则打包时会自动修补镜像中的'''vbmeta'''，添加禁用验证标识

=== 验证 ===
<pre>magiskboot verify <镜像路径> [x509.pem式的证书路径]</pre>

验证镜像是否被AVB1.0签名

若传入证书路径，则会用证书验证镜像签名

=== 签名 ===
<pre>magiskboot sign <镜像路径> [name] [x509.pem/pk8私钥文件]</pre>

签名boot镜像

若不传入私钥文件，则使用magiskboot内部的AOSP私钥签名

TODO: <code>name</code>作用未知，默认为<code>/boot</code>

此操作将会直接覆写镜像

=== 解包payload.bin ===
<pre>magiskboot extract <payload.bin路径> [分区名] [输出路径]</pre>

解包payload.bin中的指定分区

如果不指定分区，则解包init_boot.img（存在则解包这个）或boot.img

默认输出路径为当前目录下<code>分区名.img</code>

可以通过将'''payload.bin路径'''传入<code>-</code>以接收标准输入，如在linux下可以

<code>cat payload.bin | magiskboot extract -</code>

=== 十六进制修补 ===
<pre>magiskboot hexpatch <文件路径> <hexpattern1> <hexpattern2></pre>

这将在文件中寻找<code>hexpattern1</code>，并替换为<code>hexpattern2</code>

示例: magiskboot hexpatch boot.img FE8067E4 A2586F7A

这将直接覆写文件

=== DTB相关 ===
<pre>magiskboot dtb <文件> <动作> [参数]</pre>

magiskboot dtb相关功能

动作:

* <code>print</code> 以树的形式输出dtb内容，添加-f参数以仅输出<code>fstab</code>节点
* <code>patch</code> 修补dtb，移除verity/avb验证，可通过环境变量<code>KEEPVERITY</code>控制
* <code>test</code> 检测dtb中fstab的合法性，若程序返回值为0则合法，1则不合法

=== 分割附加dtb的kernel ===
<pre>magiskboot split [-n] <文件路径></pre>

将Image.*-dtb分割开为'''kernel'''和'''kernel_dtb'''

若指定<code>-n</code>参数，则Image不会解压缩

=== 输出文件sha1 ===
<pre>magiskboot sha1 <文件路径></pre>

输出文件的sha1值

=== 清理工作目录 ===
<pre>magiskboot cleanup</pre>

清除magiskboot解包等操作的产物

=== 压缩 ===
<pre>magiskboot compress[=格式] <文件路径> [输出文件路径]</pre>

进行压缩操作

文件路径与输出文件路径均可为<code>-</code>以接收标准输入/标准输出

如果不指定格式，默认为gzip

如果不指定输出文件路径，则为当前目录下'''文件路径加上该压缩格式的扩展名'''

支持格式: gzip zopfli xz lzma bzip2 lz4 lz4_legacy lz4_lg

=== 解压缩 ===
<pre>magiskboot decompress <文件路径> [输出文件路径]</pre>

进行解压缩操作

文件路径与输出文件路径均可为<code>-</code>以接收标准输入/标准输出

若不指定输出文件路径，则为当前目录下'''文件路径去掉该压缩格式的扩展名'''

'''注:如果要解压缩的文件无扩展名，则可能报错'''

支持格式同压缩

首页

2024-08-18T12:00:16Z

InnoSofts-Bit：/* 进阶内容 */ 为magiskboot添加链接

== 欢迎来到 [[文件:UotanWiki.png|120px]] · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{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]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[KaleidoscopeOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingOS]]
注：以上排序不分先后

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

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

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

首页

2024-08-18T11:59:55Z

InnoSofts-Bit：/* 进阶内容 */ 添加词条 magiskboot

== 欢迎来到 [[文件:UotanWiki.png|120px]] · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

'''本站现有{{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]]
# [[EvolutionX]]
# [[exTHmUI]]
# [[GrapheneOS]]
# [[KaleidoscopeOS]]
# [[LineageOS]]
# [[Miku|Miku UI]]
# [[Mokee]]
# [[PixelExperience]]
# [[RisingOS]]
注：以上排序不分先后

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

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

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

获取Root权限

2024-08-18T11:55:35Z

InnoSofts-Bit：强烈建议 add: APatch

== 首先了解一下Android系统中Root权限的概念 ==
同Linux相似，Android系统中的Root权限是Android系统中的最高权限，可以完成绝大部分需要高权限的操作

'''<big>因此，获取Root权限后，应妥善管理，不应给可疑软件Root权限，更不应随意使用Root权限修改系统文件，因Root权限管理/使用不当导致的问题，轻则系统出现bug，重则变砖！</big>'''

=== <big>操作前准备</big> ===

* 设备Bootloader已解锁
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

=== <big>正式操作</big> ===
'''<big>目前有三种主流的Root方案:[[Magisk|Magisk（面具）]] [[KernelSU]] 与 [[APatch]]</big>'''

Magisk是建议的root方案，它比较简单，适用于入门用户

KernelSU较为高级，且兼容的内核版本没有Magisk广泛，但KernelSU在内核层面提供root，反检测能力更强，适用于高级用户

APatch是内核层面的root，但提供了Magisk的修补功能

'''<big>强烈建议：在刷入Magisk,KernelSU或APatch前备份boot镜像，供无法开机时恢复</big>'''

=== '''<big>---------- 1.使用Magisk ----------</big>''' ===

=== 方案一:提取boot并刷入（较稳定） ===

==== 1.获取设备的boot镜像 ====
获取boot镜像的一般方式是从刷机包中提取

'''注:如果设备的内核版本为5.15.XX – 6.1.XX，且内核版本中含有"android13"或更高android版本的字符串，请提取init_boot.img而不是boot.img，此时下文的"boot镜像"指的是init_boot.img;否则提取boot.img即可'''

从官方网站/其他途径下载该设备的（认真核对，设备代号必须一致），系统版本一致的卡刷包/线刷包

'''如果获取的刷机包不是zip格式，请自行在网上寻找解包方法'''

以压缩文件方式打开刷机包，一般会有两种情况:

1.可以直接看到boot.img/init_boot.img，提取即可

2.没有boot.img/init_boot.img，但是有payload.bin，请参考Magisk中文网的[https://magiskcn.com/payload-dumper-go-boot 教程]提取出boot镜像

==== 2.使用Magisk修补boot镜像 ====

===== 方法一：APP修补 =====
1.将提取的boot镜像传到设备上，在设备上下载并安装Magisk，点击主页"Magisk"卡片右上角的"安装"

2.Magisk可能会提供一些选项，若无特殊需求则直接点击"下一步"，若没有则忽略

3.点击"选择并修补一个文件"，选择提取的boot镜像，点击"开始"，等待

4.依照Magisk输出中给出的修补后的镜像路径，将修补后的镜像传给电脑

'''注：有些机型支持使用fastboot boot boot镜像路径的方式来临时启动boot镜像，如果magisk正常工作，再使用刷入命令刷入'''

'''这样的好处在于，如果magisk没有正常工作，可以直接重启来恢复，建议优先使用该方法'''

5.手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

fastboot flash boot 修补后的boot镜像路径

如果设备为AB分区，请附加槽位后缀，默认为当前活动槽位

（如果设备刷入了第三方Recovery，可忽略第4步和第5步，直接在Recovery中刷入镜像）

不出意外，fastboot应该刷入成功，重启设备，设备应该正常开机，Magisk正常工作

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

若不能正常工作，请刷回原来的boot镜像，使用该指令:

fastboot flash boot boot镜像路径

===== 方法二：使用柚坛工具箱修补 =====
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|630x630像素]]
在柚坛工具箱的基本刷入页面的修补Boot中，选择提取出的Boot镜像，在选择文件一行中，可以更换需要使用的Magisk安装包，不更换则自动使用工具箱默认的版本。一般情况下，下面的5个选项保持默认即可。随后，点击开始修补。

修补完成后工具箱会提示是否刷入至当前设备，选择是即可刷入至当前连接的设备（请确保设备处于Fastboot模式），选择否将自动打开修补后的boot所在的文件夹。

=== 方案二：使用第三方Recovery卡刷 ===
这种方法更简便，尤其是设备刷入了第三方Recovery，而boot镜像的获取比较困难之时，可选择直接卡刷

这种方案仅需要:

# 获取Magisk安装包并安装，但是不要删除安装包
# 在第三方Recovery中直接安装该Magisk安装包.如果Recovery的刷入界面中找不到Magisk安装包，请在文件管理中把安装包的后缀改为.zip
# 重启.不出意外，Magisk正常工作

如果Magisk没有正常工作，请使用Recovery或电脑刷入备份的boot镜像

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

=== '''---------- 2.使用KernelSU ----------''' ===
'''注:使用KernelSU获取Root权限相对于Magisk复杂一点，且部分Magisk模块可能不兼容KernelSU，请谨慎选择'''

==== <big>操作前准备</big> ====

* 设备Bootloader已解锁
* 设备使用的是gki内核（不知道什么是gki内核没关系，可使用KernelSU管理器查看，见下文）
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

==== <big>正式操作</big> ====

==== 1.检查支持 ====
从[https://github.com/tiann/KernelSU/releases KernelSU GitHub Release]下载KernelSU管理器（文件名为xxx.apk，建议最新版本）后安装并打开

如果KernelSU显示的是"不支持"，则表明KernelSU不支持该设备，这很大概率上是因为设备内核非gki内核

你可以尝试自己编译内核，但这不是本章节讨论的内容

如果KernelSU显示的是"未安装"，则表明设备支持KernelSU，可以进行下一步操作

==== 2.获取内核并刷入 ====
'''<big>强烈建议：在刷入KernelSU前备份设备boot镜像，以供无法启动时恢复</big>'''

===== 方案一：手动处理 =====

====== 方法一：GKI ======
首先查看你的内核版本，看完下文gki内核版本概述，并在[https://github.com/tiann/KernelSU/releases KernelSU GitHub Release]获取正确的boot镜像

gki内核的内核版本大致的组成是这样的:

<code>内核大版本.patchlevel.sublevel-内核android版本-KmiGeneration-其他</code>

比如一个内核的内核版本为<code>5.10.335-android13-9-g12345678</code>

那么，该内核的'''内核大版本'''为5，'''patchlevel'''为10，'''sublevel'''为335，'''内核android版本'''为13，'''KmiGeneration'''为9，g12345678为其他部分

刷入的boot镜像中 '''内核大版本'''，'''patchlevel'''，'''内核android版本'''和'''KmiGeneration'''必须一致，'''理论上'''sublevel不一致也能开机

boot镜像的内核压缩方式也需要注意，不同机型有不同的压缩方式，一般是'''lz4'''和'''gzip'''，小米设备主要是gzip

如何确定压缩方式?

在电脑上下载magiskboot（[https://mrzzoxo.lanzoui.com/b02r7q0dg 来自于KernelSU中文网的下载链接]），在magiskboot同级目录打开命令提示符

输入如下指令:
<pre>magiskboot unpack 设备原boot镜像路径</pre>

并查看输出的<code>KERNEL_FMT</code>

即为内核压缩方式

同样需要注意'''Android安全补丁级别'''，最好刷入'''Android安全补丁级别'''一致的boot镜像，否则可能会不开机

在KernelSU github release中获取'''内核android版本'''，'''内核大版本'''，'''patchlevel'''，'''Android安全补丁级别'''，'''内核压缩方式'''一致的boot镜像

（最好sublevel也一致）

'''<big>下面开始刷入boot镜像</big>'''

'''注：建议先临时启动boot镜像，若无问题再进行刷入;指令:
fastboot boot boot镜像路径

'''如果设备刷入了第三方Recovery，可以使用Recovery进行刷入镜像操作'''

手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

fastboot flash boot boot镜像路径

如果设备为AB分区，请附加槽位后缀，默认为当前活动槽位

不出意外，fastboot应该刷入成功. 重启设备，若成功进入系统，且KernelSU管理器显示"工作中"，则刷入成功

如果KernelSU没有正常工作，使用如下指令刷入备份的boot镜像来恢复:

fastboot flash boot 备份的原boot镜像路径

====== 方法二：LKM（较为简便） ======
KernelSU现在对于GKI内核提供LKM安装方法，实现了与Magisk相似的修补功能

LKM的优点在于不需要刷入GKI内核，仅让KernelSU作为一个内核模块加入到内核，较为便捷

方法:

# 打开KernelSU管理器，点击"未安装"红色卡片
# 无特殊需求则选择"选择并修补一个文件"
# 选择设备当前的boot镜像
# 等待修补完成，然后刷入修补后的boot重启即可（刷入参见上文）

注意，KernelSU拒绝修补已经被Magisk修补后的boot镜像

===== 方案二：使用柚坛工具箱实现KernelSU =====
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|702x702像素]]
在柚坛工具的基本刷入的修补Boot部分中，可以在选择文件中选择[https://github.com/tiann/KernelSU/releases KernelSU github release]提供的AnyKernel文件或KO文件*，随后在选择Boot 中选择提取出的Boot文件，随后点击开始修补。

修补完成后工具箱会提示是否刷入至当前设备，选择是即可刷入至当前连接的设备（请确保设备处于Fastboot模式），选择否将自动打开修补后的boot所在的文件夹。

<nowiki>*</nowiki>3.0版本的柚坛工具箱暂不支持选择KO文件，该功能将于3.1版本支持。

=== ---------- 3.使用APatch ---------- ===
可以从[[APatch|这里]]了解APatch

使用方法:

# 从[https://github.com/bmax121/APatch/releases Github]下载APatch管理器并打开
# 点击"安装"，输入一个Root密钥（Root密钥是用APatch获取Root权限的必要数据，丢失会导致无法使用Root权限，请妥善保管）
# 选择当前的设备boot镜像，有需要可嵌入模块
# 修补，刷入（刷入见上文）
# 打开APatch，输入Root密钥，安装系统补丁

如果你的boot镜像修补失败，很大概率是因为内核未启用完整的kallsyms支持(CONFIG_KALLSYMS_ALL）

获取Root权限

2024-08-18T11:16:30Z

InnoSofts-Bit：添加KernelSU LKM

== 首先了解一下Android系统中Root权限的概念 ==
同Linux相似，Android系统中的Root权限是Android系统中的最高权限，可以完成绝大部分需要高权限的操作

'''<big>因此，获取Root权限后，应妥善管理，不应给可疑软件Root权限，更不应随意使用Root权限修改系统文件，因Root权限管理/使用不当导致的问题，轻则系统出现bug，重则变砖！</big>'''

=== <big>操作前准备</big> ===

* 设备Bootloader已解锁
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

=== <big>正式操作</big> ===
'''<big>目前有三种主流的Root方案:[[Magisk|Magisk（面具）]] [[KernelSU]] 与 [[APatch]]</big>'''

Magisk是建议的root方案，它比较简单，适用于入门用户

KernelSU较为高级，且兼容的内核版本没有Magisk广泛，但KernelSU在内核层面提供root，反检测能力更强，适用于高级用户

APatch是内核层面的root，但提供了Magisk的修补功能

'''<big>强烈建议：在刷入Magisk或KernelSU前备份boot镜像，供无法开机时恢复</big>'''

=== '''<big>---------- 1.使用Magisk ----------</big>''' ===

=== 方案一:提取boot并刷入（较稳定） ===

==== 1.获取设备的boot镜像 ====
获取boot镜像的一般方式是从刷机包中提取

'''注:如果设备的内核版本为5.15.XX – 6.1.XX，且内核版本中含有"android13"或更高android版本的字符串，请提取init_boot.img而不是boot.img，此时下文的"boot镜像"指的是init_boot.img;否则提取boot.img即可'''

从官方网站/其他途径下载该设备的（认真核对，设备代号必须一致），系统版本一致的卡刷包/线刷包

'''如果获取的刷机包不是zip格式，请自行在网上寻找解包方法'''

以压缩文件方式打开刷机包，一般会有两种情况:

1.可以直接看到boot.img/init_boot.img，提取即可

2.没有boot.img/init_boot.img，但是有payload.bin，请参考Magisk中文网的[https://magiskcn.com/payload-dumper-go-boot 教程]提取出boot镜像

==== 2.使用Magisk修补boot镜像 ====

===== 方法一：APP修补 =====
1.将提取的boot镜像传到设备上，在设备上下载并安装Magisk，点击主页"Magisk"卡片右上角的"安装"

2.Magisk可能会提供一些选项，若无特殊需求则直接点击"下一步"，若没有则忽略

3.点击"选择并修补一个文件"，选择提取的boot镜像，点击"开始"，等待

4.依照Magisk输出中给出的修补后的镜像路径，将修补后的镜像传给电脑

'''注：有些机型支持使用fastboot boot boot镜像路径的方式来临时启动boot镜像，如果magisk正常工作，再使用刷入命令刷入'''

'''这样的好处在于，如果magisk没有正常工作，可以直接重启来恢复，建议优先使用该方法'''

5.手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

fastboot flash boot 修补后的boot镜像路径

如果设备为AB分区，请附加槽位后缀，默认为当前活动槽位

（如果设备刷入了第三方Recovery，可忽略第4步和第5步，直接在Recovery中刷入镜像）

不出意外，fastboot应该刷入成功，重启设备，设备应该正常开机，Magisk正常工作

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

若不能正常工作，请刷回原来的boot镜像，使用该指令:

fastboot flash boot boot镜像路径

===== 方法二：使用柚坛工具箱修补 =====
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|630x630像素]]
在柚坛工具箱的基本刷入页面的修补Boot中，选择提取出的Boot镜像，在选择文件一行中，可以更换需要使用的Magisk安装包，不更换则自动使用工具箱默认的版本。一般情况下，下面的5个选项保持默认即可。随后，点击开始修补。

修补完成后工具箱会提示是否刷入至当前设备，选择是即可刷入至当前连接的设备（请确保设备处于Fastboot模式），选择否将自动打开修补后的boot所在的文件夹。

=== 方案二：使用第三方Recovery卡刷 ===
这种方法更简便，尤其是设备刷入了第三方Recovery，而boot镜像的获取比较困难之时，可选择直接卡刷

这种方案仅需要:

# 获取Magisk安装包并安装，但是不要删除安装包
# 在第三方Recovery中直接安装该Magisk安装包.如果Recovery的刷入界面中找不到Magisk安装包，请在文件管理中把安装包的后缀改为.zip
# 重启.不出意外，Magisk正常工作

如果Magisk没有正常工作，请使用Recovery或电脑刷入备份的boot镜像

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

=== '''---------- 2.使用KernelSU ----------''' ===
'''注:使用KernelSU获取Root权限相对于Magisk复杂一点，且部分Magisk模块可能不兼容KernelSU，请谨慎选择'''

==== <big>操作前准备</big> ====

* 设备Bootloader已解锁
* 设备使用的是gki内核（不知道什么是gki内核没关系，可使用KernelSU管理器查看，见下文）
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

==== <big>正式操作</big> ====

==== 1.检查支持 ====
从[https://github.com/tiann/KernelSU/releases KernelSU GitHub Release]下载KernelSU管理器（文件名为xxx.apk，建议最新版本）后安装并打开

如果KernelSU显示的是"不支持"，则表明KernelSU不支持该设备，这很大概率上是因为设备内核非gki内核

你可以尝试自己编译内核，但这不是本章节讨论的内容

如果KernelSU显示的是"未安装"，则表明设备支持KernelSU，可以进行下一步操作

==== 2.获取内核并刷入 ====
'''<big>强烈建议：在刷入KernelSU前备份设备boot镜像，以供无法启动时恢复</big>'''

===== 方案一：手动处理 =====

====== 方法一：GKI ======
首先查看你的内核版本，看完下文gki内核版本概述，并在[https://github.com/tiann/KernelSU/releases KernelSU GitHub Release]获取正确的boot镜像

gki内核的内核版本大致的组成是这样的:

<code>内核大版本.patchlevel.sublevel-内核android版本-KmiGeneration-其他</code>

比如一个内核的内核版本为<code>5.10.335-android13-9-g12345678</code>

那么，该内核的'''内核大版本'''为5，'''patchlevel'''为10，'''sublevel'''为335，'''内核android版本'''为13，'''KmiGeneration'''为9，g12345678为其他部分

刷入的boot镜像中 '''内核大版本'''，'''patchlevel'''，'''内核android版本'''和'''KmiGeneration'''必须一致，'''理论上'''sublevel不一致也能开机

boot镜像的内核压缩方式也需要注意，不同机型有不同的压缩方式，一般是'''lz4'''和'''gzip'''，小米设备主要是gzip

如何确定压缩方式?

在电脑上下载magiskboot（[https://mrzzoxo.lanzoui.com/b02r7q0dg 来自于KernelSU中文网的下载链接]），在magiskboot同级目录打开命令提示符

输入如下指令:
<pre>magiskboot unpack 设备原boot镜像路径</pre>

并查看输出的<code>KERNEL_FMT</code>

即为内核压缩方式

同样需要注意'''Android安全补丁级别'''，最好刷入'''Android安全补丁级别'''一致的boot镜像，否则可能会不开机

在KernelSU github release中获取'''内核android版本'''，'''内核大版本'''，'''patchlevel'''，'''Android安全补丁级别'''，'''内核压缩方式'''一致的boot镜像

（最好sublevel也一致）

'''<big>下面开始刷入boot镜像</big>'''

'''注：建议先临时启动boot镜像，若无问题再进行刷入;指令:
fastboot boot boot镜像路径

'''如果设备刷入了第三方Recovery，可以使用Recovery进行刷入镜像操作'''

手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

fastboot flash boot boot镜像路径

如果设备为AB分区，请附加槽位后缀，默认为当前活动槽位

不出意外，fastboot应该刷入成功. 重启设备，若成功进入系统，且KernelSU管理器显示"工作中"，则刷入成功

如果KernelSU没有正常工作，使用如下指令刷入备份的boot镜像来恢复:

fastboot flash boot 备份的原boot镜像路径

====== 方法二：LKM（较为简便） ======
KernelSU现在对于GKI内核提供LKM安装方法，实现了与Magisk相似的修补功能

LKM的优点在于不需要刷入GKI内核，仅让KernelSU作为一个内核模块加入到内核，较为便捷

方法:

# 打开KernelSU管理器，点击"未安装"红色卡片
# 无特殊需求则选择"选择并修补一个文件"
# 选择设备当前的boot镜像
# 等待修补完成，然后刷入修补后的boot重启即可（刷入参见上文）

注意，KernelSU拒绝修补已经被Magisk修补后的boot镜像

===== 方案二：使用柚坛工具箱实现KernelSU =====
[[文件:柚坛工具箱基本刷入页面.png|居中|缩略图|702x702像素]]
在柚坛工具的基本刷入的修补Boot部分中，可以在选择文件中选择[https://github.com/tiann/KernelSU/releases KernelSU github release]提供的AnyKernel文件或KO文件*，随后在选择Boot 中选择提取出的Boot文件，随后点击开始修补。

修补完成后工具箱会提示是否刷入至当前设备，选择是即可刷入至当前连接的设备（请确保设备处于Fastboot模式），选择否将自动打开修补后的boot所在的文件夹。

<nowiki>*</nowiki>3.0版本的柚坛工具箱暂不支持选择KO文件，该功能将于3.1版本支持。

=== ---------- 3.使用APatch ---------- ===
可以从[[APatch|这里]]了解APatch

使用方法:

# 从[https://github.com/bmax121/APatch/releases Github]下载APatch管理器并打开
# 点击"安装"，输入一个Root密钥（Root密钥是用APatch获取Root权限的必要数据，丢失会导致无法使用Root权限，请妥善保管）
# 选择当前的设备boot镜像，有需要可嵌入模块
# 修补，刷入（刷入见上文）
# 打开APatch，输入Root密钥，安装系统补丁

如果你的boot镜像修补失败，很大概率是因为内核未启用完整的kallsyms支持(CONFIG_KALLSYMS_ALL）

APatch

2024-08-18T11:15:19Z

InnoSofts-Bit：添加词条 APatch

== 什么是APatch? ==
APatch是类似于KernelSU的Root方案，创建者为Github Username '''bmax121'''

与KernelSU相似，它同样通过修改内核来实现Root，同样是内核级别的Root权限

== 特点: ==

* APatch使用KernelSU的模块系统
* APatch直接修补现有内核而无需内核源码，它通过读取内核的kallsyms（内核符号表）获取特定函数的地址，然后进行hook
* 并且APatch提供了内核模块的相关功能

所以，APatch更像是Magisk与KernelSU的结合

KaleidoscopeOS

2024-08-18T10:31:27Z

InnoSofts-Bit：KaleidoscopeOS 类原生界面创建

[[文件:Kaleidoscope Logo.png|居中|缩略图]]
KaleidoscopeOS（万花筒OS）是一个基于LineageOS的Android类原生系统

目前提供Android12-Android13，Android14仍在适配，暂不可用

看起来省电简洁，Google play可以动态开关

官方无Vanilla包

官网: [https://kaleidoscope.ink/ KaleidoscopeOS]

Github: [https://github.com/Project-Kaleidoscope KaleidoscopeOS]

文件:Kaleidoscope Logo.png

2024-08-18T10:22:10Z

InnoSofts-Bit：

DroidX

2024-08-18T10:16:51Z

InnoSofts-Bit：DroidX 类原生界面创建

[[文件:DroidX Logo.jpeg|居中|缩略图]]
Droidx-UI是一个基于LineageOS的Android类原生项目

目前有Android13与Android14的Vanilla与Gapps包可选，且仍在持续更新

官网: [https://droidx-ui.github.io/DxWeb/ Droidx-UI]

Github: [https://github.com/DroidX-UI DroidX-UI]

Sourceforge: [https://sourceforge.net/projects/droidxui-releases Droidx-UI]

文件:DroidX Logo.jpeg

2024-08-18T10:12:31Z

InnoSofts-Bit：

ArrowOS

2024-08-17T13:55:55Z

InnoSofts-Bit：ArrowOS 类原生界面创建

[[文件:ArrowOS Logo.png|居中|缩略图]]
ArrowOS是一个基于AOSP的Android类原生项目，该项目目前包含Android8.0-Android13.0的Android版本

截止到2024/08/17 该项目仍然停留在Android13而未更新，且manifest最后一次更改在7月前

同样具有Vanilla和Gapps两种包

官网: [https://arrowos.net/ ArrowOS]

Github: [https://github.com/ArrowOS/ ArrowOS]

文件:ArrowOS Logo.png

2024-08-17T13:47:34Z

InnoSofts-Bit：

Recovery 刷机基本操作

2024-08-15T12:32:05Z

InnoSofts-Bit：添加章节 Recovery 刷机基本操作

本章将讨论使用Recovery进行刷机相关的基本操作

由于除AOSP Recovery和厂商定制Recovery外，第三方Recovery绝大部分基于TWRP，下方文档以TWRP为准，其他Recovery请自行对照

== 双清/格式化Data/高级清除 ==

=== 双清 ===
双清指的是清除Dalvik缓存，Cache分区和Data分区（不包含内部存储）的操作

一般的刷机过程只需要双清，目的是为了使新系统的兼容性达到最高

如果刷入新系统后出现卡在第二屏的情况，很大概率是没有双清

注:如果要刷入的系统和原系统一致并且版本高于原系统，则'''理论上'''可以不双清

'''双清操作需要Recovery能够解密Data，如果不能，则请见下文格式化Data分区'''

操作:

在TWRP主界面点击'''清除，'''进入如下界面
[[文件:TWRP Wipe.png|居中|缩略图|440x440像素]]
直接滑动下面的滑块即可
[[文件:TWRP Wipe Complete.png|居中|缩略图|440x440像素]]

=== 格式化Data ===
格式化Data将清除'''整个Data'''的数据，包括内部存储及用户的'''任何数据'''以及Data存在的加密

这将使新系统的兼容性更高，因为有些Data分区可能含有加密，而要刷入的新系统不加密Data

注意，如果Recovery不能解密Data，则只能进行格式化Data操作而不能双清

操作:在TWRP主界面进入'''清除'''界面，点击'''格式化Data'''，输入'''yes'''后确定即可

=== 高级清除 ===
高级清除是自定义清除分区的操作，并不常用，仅在有明确需求时使用

该操作可以自行选择清除哪个分区

操作:在TWRP主界面进入'''清除'''界面，点击'''高级清除'''，选择要清除的分区，划动滑块即可

== 一般卡刷 ==
卡刷指的是用Recovery刷入刷机包的操作，是刷新系统的常规刷入方法

卡刷同样用于刷入其他包，如Magisk卡刷，Anykernel卡刷等

在刷入新系统时，请先参阅'''双清'''部分

操作:

在TWRP主界面进入安装界面，如图
[[文件:TWRP Flash File Select.png|居中|缩略图|440x440像素]]
选择要刷入的刷机包，如果你的TWRP不能解密data，则请参考[[ADB SideLoad|ADB Sideload]]

在下一步界面时进行简单设置，划动滑块刷入即可
[[文件:TWRP Flashing.png|居中|缩略图|440x440像素]]

== 备份&恢复 ==

=== 备份 ===
备份可以将设备上的分区保存到文件，供必要时进行恢复

注意，要使用备份功能，Recovery必须解密Data，或者外接存储设备

操作:

在TWRP界面选择备份，如图
[[文件:TWRP Backup.png|居中|缩略图|440x440像素]]
选择要备份的分区，需要时可调整存储位置，然后直接划动滑块，开始备份，如图
[[文件:TWRP Backup Complete.png|居中|缩略图|440x440像素]]
PS:有些TWRP对于某些镜像（如system和vendor）会提供一个带镜像字样的选项

区别在于，不带镜像字样的选项为sparse img只备份关键内容，更小

而带着的则是raw image，提取整个分区，通常为整个分区的大小

=== 恢复 ===
恢复用于恢复TWRP备份过的分区

操作方法:

在TWRP主界面点击恢复，如图
[[文件:TWRP Restore Select.png|居中|缩略图|440x440像素]]
选择要进行恢复的恢复包，或切换存储位置

选择后进入如下界面
[[文件:TWRP Restore.png|居中|缩略图|440x440像素]]
选择要恢复的分区，或删除备份

划动滑块即可开始恢复
[[文件:TWRP Restore Complete.png|居中|缩略图|440x440像素]]

== 挂载 ==
挂载指的是将块设备挂载到某个目录以访问其中文件的操作，如果不挂载，则无法访问分区内文件

进入TWRP的挂载界面，可以选择挂载或卸载分区，或者启用/禁用MTP模式

MTP模式可以让手机与电脑通过MTP协议进行文件传输

注:如果不解密Data则无法挂载Data分区，MTP模式也将不可用

文件:TWRP Restore Complete.png

2024-08-15T12:20:36Z

InnoSofts-Bit：

TWRP_Restore_Complete

文件:TWRP Restore.png

2024-08-15T12:19:25Z

InnoSofts-Bit：

TWRP_Restore

文件:TWRP Restore Select.png

2024-08-15T12:18:24Z

InnoSofts-Bit：

TWRP_Restore_Select

文件:TWRP Backup Complete.png

2024-08-15T12:12:47Z

InnoSofts-Bit：

TWRP_Backup_Complete

文件:TWRP Backup.png

2024-08-15T12:11:26Z

InnoSofts-Bit：

TWRP_Backup

文件:TWRP Flashing.png

2024-08-15T11:11:06Z

InnoSofts-Bit：

TWRP_Flashing

文件:TWRP Flash File Select.png

2024-08-15T11:08:27Z

InnoSofts-Bit：

TWRP_Flash_File_Select

文件:TWRP Wipe Complete.png

2024-08-15T11:02:29Z

InnoSofts-Bit：

TWRP_Wipe_Complete

文件:TWRP Wipe.png

2024-08-15T10:52:44Z

InnoSofts-Bit：InnoSofts-Bit上传文件:TWRP Wipe.png的新版本

TWRP Wipe

文件:TWRP Wipe.png

2024-08-15T10:51:27Z

InnoSofts-Bit：

TWRP Wipe

首页

2024-08-15T10:22:56Z

InnoSofts-Bit：/* 刷机入门 */ 添加章节 Recovery 刷机基本操作

== 欢迎来到 [[文件:UotanWiki.png|120px]] · 刷机百科 ==
'''我们致力于打造一个更适合国人使用、更贴近刷机本身的玩机知识站点'''

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

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

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

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

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

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

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

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

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

CrDroid

2024-08-15T10:08:39Z

InnoSofts-Bit：crDroid 类原生界面创建

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

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

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

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

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

下面附上crDroid10.2在evergo上的截图:
[[文件:CrDroid1.png|缩略图|[[文件:CrDroid2.png|缩略图|[[文件:CrDroid3.png|缩略图|[[文件:CrDroid4.png|缩略图]]]]]]]]

文件:CrDroid4.png

2024-08-15T10:08:06Z

InnoSofts-Bit：

文件:CrDroid3.png

2024-08-15T10:07:39Z

InnoSofts-Bit：

文件:CrDroid2.png

2024-08-15T10:06:43Z

InnoSofts-Bit：

文件:CrDroid1.png

2024-08-15T10:06:01Z

InnoSofts-Bit：

AOSPA

2024-08-15T09:57:50Z

InnoSofts-Bit：AOSPA类原生界面创建

<gallery>
文件:AOSPA.png|Logo(?)
</gallery>AOSPA(Paranoid Android)是一个基于AOSP的Android类原生项目，比较接近原生的AOSP系统，自定义选项并不多

目前有Android13和Android14两个Android版本，同样具有Vanilla和Gapps两种包，持续更新

官网: [https://paranoidandroid.co/ AOSPA]

Github: [https://github.com/AOSPA Github]

文件:AOSPA.png

2024-08-15T09:55:39Z

InnoSofts-Bit：

AlphaDroid

2024-08-13T08:36:39Z

InnoSofts-Bit：创建AlphaDroid类原生界面

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

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

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

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

Sourceforge: [https://sourceforge.net/projects/alphadroid-project Sourceforge]
[[文件:AlphaDroid3.jpg|缩略图]]
（这里附上几张AlphaDroid 13在vince上的截图）
[[文件:AlphaDroid1.jpg|缩略图]]
[[文件:AlphaDroid2.jpg|缩略图]]

文件:AlphaDroid3.jpg

2024-08-13T08:35:22Z

InnoSofts-Bit：

文件:AlphaDroid2.jpg

2024-08-13T08:34:57Z

InnoSofts-Bit：

文件:AlphaDroid1.jpg

2024-08-13T08:34:26Z

InnoSofts-Bit：

文件:Alphadroid.png

2024-08-13T08:27:51Z

InnoSofts-Bit：

AfterLife

2024-08-13T08:27:09Z

InnoSofts-Bit：添加官网地址

<gallery>
文件:Afterlife.png|Logo
</gallery>Afterlife Project是基于AOSP的Android类原生项目，创建于2023年7月，包含Android13和Android14

正在持续更新，有Vanilla和Gapps两个版本的包供选择

官网: [https://afterlifeos.com AfterlifeOS]

Github组织: [https://github.com/AfterlifeOS AfterlifeOS]

Sourceforge: [https://sourceforge.net/projects/afterlife-projects Sourceforge]

AfterLife

2024-08-13T08:24:54Z

InnoSofts-Bit：Afterlife 添加Logo

<gallery>
文件:Afterlife.png|Logo
</gallery>Afterlife Project是基于AOSP的Android类原生项目，创建于2023年7月，包含Android13和Android14

正在持续更新，有Vanilla和Gapps两个版本的包供选择

Github组织: [https://github.com/AfterlifeOS AfterlifeOS]

Sourceforge: [https://sourceforge.net/projects/afterlife-projects Sourceforge]

文件:Afterlife.png

2024-08-13T08:23:32Z

InnoSofts-Bit：

AfterLife

2024-08-13T08:20:50Z

InnoSofts-Bit：创建Afterlife类原生页面

Afterlife Project是基于AOSP的Android类原生项目，创建于2023年7月，包含Android13和Android14

正在持续更新，有Vanilla和Gapps两个版本的包供选择

Github组织: [https://github.com/AfterlifeOS AfterlifeOS]

Sourceforge: [https://sourceforge.net/projects/afterlife-projects Sourceforge]

提取分区

2024-02-16T14:07:20Z

InnoSofts-Bit：三种 -> 四种

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

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

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

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

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

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

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

通过root权限提取分区主要是与块设备通信. Android中的块设备与Linux相似，可以通过块设备来读写分区

'''每个机型的提取方式可能不同，请自行在<code>/dev/block</code>下查看'''

以红米5p举例，分区所在的块设备路径在:

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

比如，若需要提取system分区，则分区所在的块设备路径为:

<pre>/dev/block/bootdevice/by-name/system</pre>

取得块设备路径后，有两种方式提取分区:

<big>'''1.通过cp指令: '''</big>

<pre>cp 块设备路径要提取到的文件路径</pre>

例如

<pre>cp /dev/block/bootdevice/by-name/system /sdcard/system.img</pre>

这会提取system分区到/sdcard/system.img

<big>'''2.通过dd指令: '''</big>

<pre>dd if=块设备路径 of=要提取到的文件路径 bs=4M</pre>

例如

<pre>dd if=/dev/block/bootdevice/by-name/system of=/sdcard/system.img bs=4M</pre>

这同样会提取system分区到/sdcard/system.img

<pre>bs=4M</pre>
意为将块大小指定为4M，由于储存器的特性，小于扇区大小会造成更多的寿命损失并增加读写时间

因此，为了加快速度并减少寿命损失，可使用类似于4M的整数

对于较老的机型，可尝试转为字节，如
<pre>bs=4M</pre>
可换为
<pre>bs=4194304</pre>

提取分区

2024-02-16T13:40:06Z

InnoSofts-Bit：排版2 使用pre

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

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

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

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

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

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

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

通过root权限提取分区主要是与块设备通信. Android中的块设备与Linux相似，可以通过块设备来读写分区

'''每个机型的提取方式可能不同，请自行在<code>/dev/block</code>下查看'''

以红米5p举例，分区所在的块设备路径在:

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

比如，若需要提取system分区，则分区所在的块设备路径为:

<pre>/dev/block/bootdevice/by-name/system</pre>

取得块设备路径后，有两种方式提取分区:

<big>'''1.通过cp指令: '''</big>

<pre>cp 块设备路径要提取到的文件路径</pre>

例如

<pre>cp /dev/block/bootdevice/by-name/system /sdcard/system.img</pre>

这会提取system分区到/sdcard/system.img

<big>'''2.通过dd指令: '''</big>

<pre>dd if=块设备路径 of=要提取到的文件路径 bs=4M</pre>

例如

<pre>dd if=/dev/block/bootdevice/by-name/system of=/sdcard/system.img bs=4M</pre>

这同样会提取system分区到/sdcard/system.img

<pre>bs=4M</pre>
意为将块大小指定为4M，由于储存器的特性，小于扇区大小会造成更多的寿命损失并增加读写时间

因此，为了加快速度并减少寿命损失，可使用类似于4M的整数

对于较老的机型，可尝试转为字节，如
<pre>bs=4M</pre>
可换为
<pre>bs=4194304</pre>

提取分区

2024-02-16T13:33:38Z

InnoSofts-Bit：排版

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

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

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

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

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

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

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

通过root权限提取分区主要是与块设备通信. Android中的块设备与Linux相似，可以通过块设备来读写分区

'''每个机型的提取方式可能不同，请自行在<code>/dev/block</code>下查看'''

以红米5p举例，分区所在的块设备路径在:

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

比如，若需要提取system分区，则分区所在的块设备路径为:

<code>/dev/block/bootdevice/by-name/system</code>

取得块设备路径后，有两种方式提取分区:

1.通过cp指令:

<code>cp 块设备路径要提取到的文件路径</code>

例如

<code>cp /dev/block/bootdevice/by-name/system /sdcard/system.img</code>

这会提取system分区到/sdcard/system.img

2.通过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-16T13:29:31Z

InnoSofts-Bit：排版 and 内核节点 -> 块设备

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

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

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

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

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

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

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

通过root权限提取分区主要是与块设备通信. Android中的块设备与Linux相似，可以通过块设备来读写分区

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

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

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

取得块设备路径后，有两种方式提取分区:

1.通过cp指令: <code>cp 块设备路径要提取到的文件路径</code>

例如

<code>cp /dev/block/bootdevice/by-name/system /sdcard/system.img</code>

这会提取system分区到/sdcard/system.img

2.通过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-16T13:07:40Z

InnoSofts-Bit：补充空缺

通常来说，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的整数. 对于较老的机型，可尝试转为字节，如<code>bs=4M</code>可换为<code>bs=4194304</code>

获取Root权限

2024-02-15T11:18:50Z

InnoSofts-Bit：语言更准确

== 首先了解一下Android系统中Root权限的概念 ==
同Linux相似，Android系统中的Root权限是Android系统中的最高权限，可以完成绝大部分需要高权限的操作

'''<big>因此，获取Root权限后，应妥善管理，不应给可疑软件Root权限，更不应随意使用Root权限修改系统文件，因Root权限管理/使用不当导致的问题，轻则系统出现bug，重则变砖</big>'''

<big>注：本章目前仅适用于A-only设备，其他设备敬请期待</big>

== 正文开始 ==

=== <big>操作前准备</big> ===

* 设备Bootloader已解锁
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

=== <big>正式操作</big> ===
'''<big>目前有两种主流的Root方案:Magisk（面具）和 KernelSU</big>'''

Magisk是建议的root方案，它比较简单，适用于入门用户

KernelSU较为高级，且兼容的内核版本没有Magisk广泛，但KernelSU在内核层面提供root，反检测能力更强，适用于高级用户

'''<big>强烈建议：在刷入Magisk前备份boot镜像，供无法开机时恢复</big>'''

=== '''<big>---------- 1.使用Magisk ----------</big>''' ===

=== 方案一:提取boot并刷入（较稳定） ===

==== 1.获取设备的boot镜像 ====
获取boot镜像的一般方式是从刷机包中提取

'''注:如果设备的内核版本为5.15.XX – 6.1.XX，且内核版本中含有"android13"或更高android版本的字符串，请提取init_boot.img而不是boot.img，此时下文的"boot镜像"指的是init_boot.img;否则提取boot.img即可'''

从官方网站/其他途径下载该设备的（认真核对，设备代号必须一致），系统版本一致的卡刷包/线刷包

'''如果获取的刷机包不是zip格式，请自行在网上寻找解包方法'''

以压缩文件方式打开刷机包，一般会有两种情况:

1.可以直接看到boot.img/init_boot.img，提取即可

2.没有boot.img/init_boot.img，但是有payload.bin，请参考Magisk中文网的[https://magiskcn.com/payload-dumper-go-boot 教程]提取出boot镜像

==== 2.使用Magisk修补boot镜像 ====
1.将提取的boot镜像传到设备上，在设备上下载并安装Magisk，点击主页"Magisk"卡片右上角的"安装"

2.Magisk可能会提供一些选项，若无特殊需求则直接点击"下一步"，若没有则忽略

3.点击"选择并修补一个文件"，选择提取的boot镜像，点击"开始"，等待

4.依照Magisk输出中给出的修补后的镜像路径，将修补后的镜像传给电脑

'''注：有些机型支持使用fastboot boot boot镜像路径的方式来临时启动boot镜像，如果magisk正常工作，再使用刷入命令刷入;这样的好处在于，如果magisk没有正常工作，可以直接重启来恢复，建议优先使用该方法'''

5.手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

<code>fastboot flash boot 修补后的boot镜像路径</code>

（如果设备刷入了第三方Recovery，可忽略第4步和第5步，直接在Recovery中刷入镜像）

不出意外，fastboot应该刷入成功，重启设备，设备应该正常开机，Magisk正常工作

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

若不能正常工作，请刷回原来的boot镜像，使用该指令:

<code>fastboot flash boot boot镜像路径</code>

=== '''方案二：使用第三方Recovery卡刷''' ===
这种方法更简便，尤其是设备刷入了第三方Recovery，而boot镜像的获取比较困难之时，直接卡刷是一个不错的选择

这种方案仅需要:

# 获取Magisk安装包并安装，但是不要删除安装包
# 在第三方Recovery中直接安装该Magisk安装包.如果Recovery的刷入界面中找不到Magisk安装包，请在文件管理中把安装包的后缀改为.zip
# 重启.不出意外，Magisk正常工作

如果Magisk没有正常工作，请使用Recovery或电脑刷入备份的boot镜像

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

=== <big>---------- 2.使用KernelSU ----------</big> ===
'''注:使用KernelSU获取Root权限相对于Magisk复杂一点，且部分Magisk模块可能不兼容KernelSU，请谨慎选择'''

==== <big>操作前准备</big> ====

* 设备Bootloader已解锁
* 设备使用的是gki内核（不知道什么是gki内核没关系，可使用KernelSU管理器查看，见下文）
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

==== <big>正式操作</big> ====

==== 1.检查支持 ====
从[https://github.com/tiann/KernelSU/releases KernelSU github release]下载KernelSU管理器（文件名为xxx.apk，建议最新版本）后安装并打开

如果KernelSU显示的是"不支持"，则表明KernelSU不支持该设备，这很大概率上是因为设备内核非gki内核.你可以尝试自己编译内核，但这不是本章节讨论的内容

如果KernelSU显示的是"未安装"，则表明设备支持KernelSU，可以进行下一步操作

==== 2.获取内核并刷入 ====
'''<big>强烈建议：在刷入KernelSU前备份设备boot镜像，以供无法启动时恢复</big>'''

首先查看你的内核版本，看完下文gki内核版本概述，并在[https://github.com/tiann/KernelSU/releases KernelSU github release]获取正确的boot镜像

gki内核的内核版本大致的组成是这样的:

<code>内核大版本.patchlevel.sublevel-内核android版本-KmiGeneration-其他</code>

比如一个内核的内核版本为<code>5.10.335-android13-9-g12345678</code>

那么，该内核的'''内核大版本'''为5，'''patchlevel'''为10，'''sublevel'''为335，'''内核android版本'''为13，'''KmiGeneration'''为9，g12345678为其他部分

刷入的boot镜像中 '''内核大版本'''，'''patchlevel'''，'''内核android版本'''和'''KmiGeneration'''必须一致，'''理论上'''sublevel不一致也能开机

boot镜像的内核压缩方式也需要注意，不同机型有不同的压缩方式，一般是'''lz4'''和'''gzip'''，小米设备主要是gzip

同样需要注意'''Android安全补丁级别'''，最好刷入'''Android安全补丁级别'''一致的boot镜像，否则可能会不开机

在KernelSU github release中获取'''内核android版本'''，'''内核大版本'''，'''patchlevel'''，'''Android安全补丁级别'''，'''内核压缩方式'''一致的boot镜像

（最好sublevel也一致）

'''<big>下面开始刷入boot镜像</big>'''

'''注：建议先临时启动boot镜像，若无问题再进行刷入;指令:<code>fastboot boot boot镜像路径</code>'''

'''如果设备刷入了第三方Recovery，可以使用Recovery进行刷入镜像操作'''

手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

<code>fastboot flash boot boot镜像路径</code>

不出意外，fastboot应该刷入成功. 重启设备，若成功进入系统，且KernelSU管理器显示"工作中"，则刷入成功

如果KernelSU没有正常工作，使用如下指令刷入备份的boot镜像来恢复:

<code>fastboot flash boot 备份的原boot镜像路径</code>

获取Root权限

2024-02-15T11:13:59Z

InnoSofts-Bit：添加一个注意

== 首先了解一下Android系统中Root权限的概念 ==
同Linux相似，Android系统中的Root权限是Android系统中的最高权限，可以完成绝大部分需要高权限的操作

'''<big>因此，获取Root权限后，应妥善管理，不应给可疑软件Root权限，更不应随意使用Root权限修改系统文件，因Root权限管理/使用不当导致的问题，轻则系统出现bug，重则变砖</big>'''

<big>注：本章目前仅适用于A-only设备，其他设备敬请期待</big>

== 正文开始 ==

=== <big>操作前准备</big> ===

* 设备Bootloader已解锁
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

=== <big>正式操作</big> ===
'''<big>目前有两种主流的Root方案:Magisk（面具）和 KernelSU</big>'''

Magisk是建议的root方案，它比较简单，适用于入门用户

KernelSU较为高级，且兼容的内核版本没有Magisk广泛，但KernelSU在内核层面提供root，反检测能力更强，适用于高级用户

'''<big>强烈建议：在刷入Magisk前备份boot镜像，供无法开机时恢复</big>'''

=== '''<big>---------- 1.使用Magisk ----------</big>''' ===

=== 方案一:提取boot并刷入（较稳定） ===

==== 1.获取设备的boot镜像 ====
获取boot镜像的一般方式是从刷机包中提取

'''注:如果设备的内核版本为5.15.XX – 6.1.XX，且内核版本中含有"android13"或更高android版本的字符串，请提取init_boot.img而不是boot.img，此时下文的"boot镜像"指的是init_boot.img;否则提取boot.img即可'''

从官方网站/其他途径下载该设备的（认真核对，设备代号必须一致），系统版本一致的卡刷包/线刷包

'''如果获取的刷机包不是zip格式，请自行在网上寻找解包方法'''

以压缩文件方式打开刷机包，一般会有两种情况:

1.可以直接看到boot.img/init_boot.img，提取即可

2.没有boot.img/init_boot.img，但是有payload.bin，请参考Magisk中文网的[https://magiskcn.com/payload-dumper-go-boot 教程]提取出boot镜像

==== 2.使用Magisk修补boot镜像 ====
1.将提取的boot镜像传到设备上，在设备上下载并安装Magisk，点击主页"Magisk"卡片右上角的"安装"

2.Magisk可能会提供一些选项，若无特殊需求则直接点击"下一步"，若没有则忽略

3.点击"选择并修补一个文件"，选择提取的boot镜像，点击"开始"，等待

4.依照Magisk输出中给出的修补后的镜像路径，将修补后的镜像传给电脑

'''注：有些机型支持使用fastboot boot boot镜像路径的方式来临时启动boot镜像，如果magisk正常工作，再使用刷入命令刷入;这样的好处在于，如果magisk没有正常工作，可以直接重启来恢复，建议优先使用该方法'''

5.手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

<code>fastboot flash boot 修补后的boot镜像路径</code>

（如果设备刷入了第三方Recovery，可忽略第4步和第5步，直接在Recovery中刷入镜像）

不出意外，fastboot应该刷入成功，重启设备，设备应该正常开机，Magisk正常工作

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

若不能正常工作，请刷回原来的boot镜像，使用该指令:

<code>fastboot flash boot boot镜像路径</code>

=== '''方案二：使用第三方Recovery卡刷''' ===
这种方法更简便，尤其是设备刷入了第三方Recovery，而boot镜像的获取比较困难之时，直接卡刷是一个不错的选择

这种方案仅需要:

# 获取Magisk安装包并安装，但是不要删除安装包
# 在第三方Recovery中直接安装该Magisk安装包.如果Recovery的刷入界面中找不到Magisk安装包，请在文件管理中把安装包的后缀改为.zip
# 重启.不出意外，Magisk正常工作

如果Magisk没有正常工作，请使用Recovery或电脑刷入备份的boot镜像

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

=== <big>---------- 2.使用KernelSU ----------</big> ===
'''注:KernelSU刷入难度相对于Magisk较大，且部分Magisk模块可能不兼容KernelSU，请谨慎选择'''

==== <big>操作前准备</big> ====

* 设备Bootloader已解锁
* 设备使用的是gki内核（不知道什么是gki内核没关系，可使用KernelSU管理器查看，见下文）
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

==== <big>正式操作</big> ====

==== 1.检查支持 ====
从[https://github.com/tiann/KernelSU/releases KernelSU github release]下载KernelSU管理器（文件名为xxx.apk，建议最新版本）后安装并打开

如果KernelSU显示的是"不支持"，则表明KernelSU不支持该设备，这很大概率上是因为设备内核非gki内核.你可以尝试自己编译内核，但这不是本章节讨论的内容

如果KernelSU显示的是"未安装"，则表明设备支持KernelSU，可以进行下一步操作

==== 2.获取内核并刷入 ====
'''<big>强烈建议：在刷入KernelSU前备份设备boot镜像，以供无法启动时恢复</big>'''

首先查看你的内核版本，看完下文gki内核版本概述，并在[https://github.com/tiann/KernelSU/releases KernelSU github release]获取正确的boot镜像

gki内核的内核版本大致的组成是这样的:

<code>内核大版本.patchlevel.sublevel-内核android版本-KmiGeneration-其他</code>

比如一个内核的内核版本为<code>5.10.335-android13-9-g12345678</code>

那么，该内核的'''内核大版本'''为5，'''patchlevel'''为10，'''sublevel'''为335，'''内核android版本'''为13，'''KmiGeneration'''为9，g12345678为其他部分

刷入的boot镜像中 '''内核大版本'''，'''patchlevel'''，'''内核android版本'''和'''KmiGeneration'''必须一致，'''理论上'''sublevel不一致也能开机

boot镜像的内核压缩方式也需要注意，不同机型有不同的压缩方式，一般是'''lz4'''和'''gzip'''，小米设备主要是gzip

同样需要注意'''Android安全补丁级别'''，最好刷入'''Android安全补丁级别'''一致的boot镜像，否则可能会不开机

在KernelSU github release中获取'''内核android版本'''，'''内核大版本'''，'''patchlevel'''，'''Android安全补丁级别'''，'''内核压缩方式'''一致的boot镜像

（最好sublevel也一致）

'''<big>下面开始刷入boot镜像</big>'''

'''注：建议先临时启动boot镜像，若无问题再进行刷入;指令:<code>fastboot boot boot镜像路径</code>'''

'''如果设备刷入了第三方Recovery，可以使用Recovery进行刷入镜像操作'''

手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

<code>fastboot flash boot boot镜像路径</code>

不出意外，fastboot应该刷入成功. 重启设备，若成功进入系统，且KernelSU管理器显示"工作中"，则刷入成功

如果KernelSU没有正常工作，使用如下指令刷入备份的boot镜像来恢复:

<code>fastboot flash boot 备份的原boot镜像路径</code>

获取Root权限

2024-02-15T11:06:03Z

InnoSofts-Bit：添加KernelSU获取root

== 首先了解一下Android系统中Root权限的概念 ==
同Linux相似，Android系统中的Root权限是Android系统中的最高权限，可以完成绝大部分需要高权限的操作

'''<big>因此，获取Root权限后，应妥善管理，不应给可疑软件Root权限，更不应随意使用Root权限修改系统文件，因Root权限管理/使用不当导致的问题，轻则系统出现bug，重则变砖</big>'''

<big>注：本章目前仅适用于A-only设备，其他设备敬请期待</big>

== 正文开始 ==

=== <big>操作前准备</big> ===

* 设备Bootloader已解锁
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

=== <big>正式操作</big> ===
'''<big>目前有两种主流的Root方案:Magisk（面具）和 KernelSU</big>'''

Magisk是建议的root方案，它比较简单，适用于入门用户

KernelSU较为高级，且兼容的内核版本没有Magisk广泛，但KernelSU在内核层面提供root，反检测能力更强，适用于高级用户

'''<big>强烈建议：在刷入Magisk前备份boot镜像，供无法开机时恢复</big>'''

=== '''<big>---------- 1.使用Magisk ----------</big>''' ===

=== 方案一:提取boot并刷入（较稳定） ===

==== 1.获取设备的boot镜像 ====
获取boot镜像的一般方式是从刷机包中提取

'''注:如果设备的内核版本为5.15.XX – 6.1.XX，且内核版本中含有"android13"或更高android版本的字符串，请提取init_boot.img而不是boot.img，此时下文的"boot镜像"指的是init_boot.img;否则提取boot.img即可'''

从官方网站/其他途径下载该设备的（认真核对，设备代号必须一致），系统版本一致的卡刷包/线刷包

'''如果获取的刷机包不是zip格式，请自行在网上寻找解包方法'''

以压缩文件方式打开刷机包，一般会有两种情况:

1.可以直接看到boot.img/init_boot.img，提取即可

2.没有boot.img/init_boot.img，但是有payload.bin，请参考Magisk中文网的[https://magiskcn.com/payload-dumper-go-boot 教程]提取出boot镜像

==== 2.使用Magisk修补boot镜像 ====
1.将提取的boot镜像传到设备上，在设备上下载并安装Magisk，点击主页"Magisk"卡片右上角的"安装"

2.Magisk可能会提供一些选项，若无特殊需求则直接点击"下一步"，若没有则忽略

3.点击"选择并修补一个文件"，选择提取的boot镜像，点击"开始"，等待

4.依照Magisk输出中给出的修补后的镜像路径，将修补后的镜像传给电脑

'''注：有些机型支持使用fastboot boot boot镜像路径的方式来临时启动boot镜像，如果magisk正常工作，再使用刷入命令刷入;这样的好处在于，如果magisk没有正常工作，可以直接重启来恢复，建议优先使用该方法'''

5.手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

<code>fastboot flash boot 修补后的boot镜像路径</code>

（如果设备刷入了第三方Recovery，可忽略第4步和第5步，直接在Recovery中刷入镜像）

不出意外，fastboot应该刷入成功，重启设备，设备应该正常开机，Magisk正常工作

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

若不能正常工作，请刷回原来的boot镜像，使用该指令:

<code>fastboot flash boot boot镜像路径</code>

=== '''方案二：使用第三方Recovery卡刷''' ===
这种方法更简便，尤其是设备刷入了第三方Recovery，而boot镜像的获取比较困难之时，直接卡刷是一个不错的选择

这种方案仅需要:

# 获取Magisk安装包并安装，但是不要删除安装包
# 在第三方Recovery中直接安装该Magisk安装包.如果Recovery的刷入界面中找不到Magisk安装包，请在文件管理中把安装包的后缀改为.zip
# 重启.不出意外，Magisk正常工作

如果Magisk没有正常工作，请使用Recovery或电脑刷入备份的boot镜像

如果打开Magisk后提示"需要修复运行环境"或其他问题，请按照指引操作，此时在刷入时可以直接选择"直接安装"

=== <big>---------- 2.使用KernelSU ----------</big> ===

==== <big>操作前准备</big> ====

* 设备Bootloader已解锁
* 设备使用的是gki内核（不知道什么是gki内核没关系，可使用KernelSU管理器查看，见下文）
* 一台电脑，数据线（最好是原装），电脑已安装驱动，已下载fastboot工具包
* （可选但推荐）给设备刷入一个第三方Recovery

==== <big>正式操作</big> ====

==== 1.检查支持 ====
从[https://github.com/tiann/KernelSU/releases KernelSU github release]下载KernelSU管理器（文件名为xxx.apk，建议最新版本）后安装并打开

如果KernelSU显示的是"不支持"，则表明KernelSU不支持该设备，这很大概率上是因为设备内核非gki内核.你可以尝试自己编译内核，但这不是本章节讨论的内容

如果KernelSU显示的是"未安装"，则表明设备支持KernelSU，可以进行下一步操作

==== 2.获取内核并刷入 ====
'''<big>强烈建议：在刷入KernelSU前备份设备boot镜像，以供无法启动时恢复</big>'''

首先查看你的内核版本，看完下文gki内核版本概述，并在[https://github.com/tiann/KernelSU/releases KernelSU github release]获取正确的boot镜像

gki内核的内核版本大致的组成是这样的:

<code>内核大版本.patchlevel.sublevel-内核android版本-KmiGeneration-其他</code>

比如一个内核的内核版本为<code>5.10.335-android13-9-g12345678</code>

那么，该内核的'''内核大版本'''为5，'''patchlevel'''为10，'''sublevel'''为335，'''内核android版本'''为13，'''KmiGeneration'''为9，g12345678为其他部分

刷入的boot镜像中 '''内核大版本'''，'''patchlevel'''，'''内核android版本'''和'''KmiGeneration'''必须一致，'''理论上'''sublevel不一致也能开机

boot镜像的内核压缩方式也需要注意，不同机型有不同的压缩方式，一般是'''lz4'''和'''gzip'''，小米设备主要是gzip

同样需要注意'''Android安全补丁级别'''，最好刷入'''Android安全补丁级别'''一致的boot镜像，否则可能会不开机

在KernelSU github release中获取'''内核android版本'''，'''内核大版本'''，'''patchlevel'''，'''Android安全补丁级别'''，'''内核压缩方式'''一致的boot镜像

（最好sublevel也一致）

'''<big>下面开始刷入boot镜像</big>'''

'''注：建议先临时启动boot镜像，若无问题再进行刷入;指令:<code>fastboot boot boot镜像路径</code>'''

'''如果设备刷入了第三方Recovery，可以使用Recovery进行刷入镜像操作'''

手机进入fastboot，用数据线连接电脑和设备，在具有fastboot的目录下执行此命令:

<code>fastboot flash boot boot镜像路径</code>

不出意外，fastboot应该刷入成功. 重启设备，若成功进入系统，且KernelSU管理器显示"工作中"，则刷入成功

如果KernelSU没有正常工作，使用如下指令刷入备份的boot镜像来恢复:

<code>fastboot flash boot 备份的原boot镜像路径</code>