150 lines
4.8 KiB
Markdown
150 lines
4.8 KiB
Markdown
# 安装参考
|
||
|
||
::: details 将会了解 SukiSU-Ultra 安装过程
|
||
[[toc]]
|
||
:::
|
||
|
||
::: danger 警告
|
||
**Root 您的设备可能会使保修失效，如果操作不当可能会造成永久性损坏。**
|
||
请务必在继续之前创建完整备份，阅读文档确保与您的设备兼容，遵循文档参考，准备好恢复计划
|
||
:::
|
||
|
||
## 通用 GKI
|
||
|
||
请**全部**参考 [KernelSU 安装指南](https://kernelsu.org/zh_CN/guide/installation.html)
|
||
|
||
1. 适用于 GKI 2.0 设备，如小米、红米、三星等（不包括内核修改的制造商，如魅族、一加、真我和 OPPO）
|
||
2. 在[更多链接](./links)中查找 GKI 构建。找到设备内核版本，然后下载并使用 TWRP 或内核刷写工具刷入带有 `AnyKernel3` 后缀的
|
||
zip 文件。
|
||
3. 无后缀的 `.zip` 档案是未压缩的，`gz` 后缀是特定型号使用的压缩格式。
|
||
|
||
## 一加设备
|
||
|
||
使用[更多链接](./links)部分提到的链接，用您的设备信息创建自定义构建，然后刷入带有 AnyKernel3 后缀的 zip 文件。
|
||
|
||
::: details 展开
|
||
|
||
- 只需要填写内核版本的前两部分，如 `5.10`、`5.15`、`6.1` 或 `6.6`。
|
||
- 请自行搜索处理器代号，通常是不含数字的英文字母。
|
||
- 可以从一加开源内核仓库中找到分支和配置文件。
|
||
- 第三方 Recovery（推荐 TWRP）
|
||
|
||
:::
|
||
|
||
## 开始安装
|
||
|
||
### 通用 GKI 安装
|
||
|
||
::: tip
|
||
适用于 GKI 2.0 设备，如小米、红米、三星等（不包括内核修改的制造商，如魅族、一加、真我和 OPPO）
|
||
:::
|
||
|
||
#### 步骤：
|
||
|
||
1. 下载 GKI 构建文件
|
||
|
||
从我们的[资源部分](./links)查找 GKI 构建。查找您设备的内核版本并下载带有 `AnyKernel3` 后缀的 `zip` 文件。
|
||
|
||
2. 通过 Recovery 刷入
|
||
|
||
启动到 `TWRP recovery`，选择 **Install**，导航到下载的 `AnyKernel3 zip` 文件，滑动刷入后重启系统
|
||
|
||
3. [验证安装](#验证)
|
||
|
||
::: details 文件格式说明
|
||
无后缀的 `.zip` 档案是未压缩的，`gz` 后缀是特定型号使用的压缩格式。
|
||
:::
|
||
|
||
### 一加设备安装
|
||
|
||
1. 获取设备信息
|
||
|
||
- 内核版本（前两部分，例如 `5.10`、`5.15`、`6.1`、`6.6`）
|
||
- 处理器代号（通常是不含数字的英文）
|
||
- 来自一加开源内核仓库的分支和配置文件
|
||
|
||
2. 创建自定义构建
|
||
|
||
使用我们[资源部分](./links)中提到的链接，用您的设备信息创建自定义构建。
|
||
|
||
3. 刷入构建
|
||
|
||
下载生成的带有 AnyKernel3 后缀的 zip 文件，启动到 `TWRP recovery`，选择 **Install**，导航到下载的 `AnyKernel3 zip` 文件，滑动刷入后重启系统
|
||
|
||
::: tip
|
||
您只需要填写内核版本的前两部分。自行搜索处理器代号
|
||
:::
|
||
|
||
### 手动内核集成
|
||
|
||
面向希望将 SukiSU Ultra 集成到自己内核构建中的高级用户
|
||
|
||
#### 主分支（GKI）
|
||
|
||
```sh [bash]
|
||
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s main
|
||
```
|
||
|
||
#### 非 GKI 分支
|
||
|
||
```sh [bash]
|
||
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s nongki
|
||
```
|
||
|
||
#### SUSFS-Dev 分支（推荐）
|
||
|
||
```sh [bash]
|
||
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s susfs-dev
|
||
```
|
||
|
||
```bash
|
||
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s susfs-main
|
||
```
|
||
|
||
::: warning 必需的内核配置
|
||
为了支持 KPM，添加 `CONFIG_KPM=y`
|
||
|
||
对于非 GKI 设备，还要添加 `CONFIG_KALLSYMS=y` 和 `CONFIG_KALLSYMS_ALL=y`
|
||
:::
|
||
|
||
## 安装后设置
|
||
|
||
### 系统更新时保持 Root
|
||
|
||
> [!IMPORTANT]
|
||
> 如何在 OTA 更新后保持 root 访问权限：
|
||
|
||
#### 步骤：
|
||
|
||
1. 系统更新后重启前
|
||
- OTA 安装后不要立即重启，将 SukiSU Ultra 安装到第二插槽
|
||
- 打开 SukiSU Ultra 管理器，在**刷入/修补内核**界面选择 **GKI/non_GKI install**，选择您的 `AnyKernel3` 内核 `zip` 文件，选择与当前运行插槽相对的插槽然后刷入重启。
|
||
|
||
2. 替代方案：LKM 模式
|
||
|
||
使用 [LKM 模式](#通用-gki) 在 OTA 后安装到未使用的插槽。
|
||
|
||
::: warning 警告
|
||
**非 GKI 设备注意事项：** 此方法不支持所有非 GKI 设备。对于非 GKI 设备，使用 TWRP 是最安全的方法。
|
||
:::
|
||
|
||
## 验证
|
||
|
||
安装后，验证一切是否正常工作，
|
||
|
||
- 打开 SukiSU Ultra 管理器检查 root 工作状态
|
||
- 使用 root 权限的应用程序来验证 root 访问是否工作正常
|
||
- 在设置 -> 关于手机中检查内核版本
|
||
|
||
## 需要帮助？
|
||
|
||
如果在安装过程中遇到问题：
|
||
|
||
1. 查看我们的[兼容性指南](./compatibility)了解设备要求
|
||
2. 访问我们的 [GitHub 仓库](https://github.com/sukisu-ultra/sukisu-ultra)获取支持
|
||
3. 加入我们的 [Telegram 社区](https://t.me/sukiksu)获取帮助
|
||
|
||
::: danger 安全提醒
|
||
**始终有备用计划！** 保留您的原始 `boot.img/init_boot.img` 并知道如何在出现问题时恢复设备。
|
||
:::
|