一加7Pro刷LineageOS 20教程（Gapps + Magisk root）

前言

0x01 本教程为一加7Pro（Oneplus 7 Pro, 设备代号为Guacamole）专用，其他型号的设备请勿参考本教程，否则出现任何意外情况，笔者将不对您负任何责任。刷机有风险，请提前备份。

0x02 在按照本教程操作前尽量确保自己具有魔法环境，笔者不提供任何除github以外的apk下载地址、除lineageos官网以外的系统镜像下载地址（如网盘等）。

一、准备工作

LineageOS 20.0的安装条件：

当前手机的系统版本为Android 12（氧OS成功；氢OS未测，理论上可行）

已经解锁bootloader

由于一加7Pro的官方ROM存在缺陷，在升级氧OS 12.1后，无法直接通过fastboot oem unlock命令来解锁bootloader，需退回到氧OS 11来解锁bootloader，再通过本地升级的方式安装氧OS 12.1，从而保留bootloader解锁状态，否则后续LineageOS 20.0将无法安装。（血和泪的教训）

Step 1.确认当前的系统版本为氧OS 11.0.X.1，X可以是4~9之间的任意值。符合要求的看Step 2。

若不符合要求：

若当前系统为氧OS 12.1，则可刷入氧OS 11.0.5.1降级包。地址：https://yun.daxiaamu.com/OnePlus_Roms_2/%E4%B8%80%E5%8A%A07%20Pro/%E9%99%8D%E7%BA%A7%E5%8C%85%E6%B0%A7OS%2011.0.5.1/

降级包会清除所有数据，注意备份，降级包刷入方法自寻。

若为其他系统，需参考一加7Pro 9008线刷方法刷入氧OS 11.0.5.1版本，线刷教程请自寻。9008线刷包可在大侠阿木的网站下载：https://yun.daxiaamu.com/OnePlus_Roms_2/%E4%B8%80%E5%8A%A07%20Pro/9008%E7%BA%BF%E5%88%B7%E6%95%91%E7%A0%96%E5%8C%85%E6%B0%A7OS%2011.0.5.1/ 

上述两种方法初次进入系统后可跳过连接网络，省时间。

Step 2.将氧OS升级至11.0.8.1或11.0.9.1（这俩任意一个都可以）。从大侠阿木网盘下载OTA升级包：

11.0.8.1：https://yun.daxiaamu.com/OnePlus_Roms_2/%E4%B8%80%E5%8A%A07%20Pro/%E6%B0%A7OS%2011.0.8.1/

11.0.9.1：

https://yun.daxiaamu.com/OnePlus_Roms_2/%E4%B8%80%E5%8A%A07%20Pro/%E6%B0%A7OS%2011.0.9.1/

将下载后的zip包放入手机sdcard根目录下。断网，进入设置-系统更新，点击右上角的三个点，选择本地安装。在选择刚放入的zip包，等待安装。期间请勿操作手机，进度100后点击重启手机。

Step 3.氧OS 11解锁bootloader（此步骤会清除所有数据，注意备份）：

开启“开发者选项”。打开设置-关于手机-版本号，点击7次后开启开发者选项

返回上一级，进入系统-开发者选项，打开“允许OEM解锁”。同时下拉找到“USB调试”并开启。

usb线连接电脑，准备Android 调试工具adb、fastboot（自己找）。在命令行输入

adb devices

手机上会出现授权页面，勾选总是，点击允许。再次输入上述命令，若出现

List of devices attached

xxxxxxxx       device

则可进行下一步。

输入命令adb reboot bootloader，或在关机状态按“音量+”、“音量-”和电源键，进入fastboot模式。此时在命令行输入 fastboot devices，应当出现设备信息。若没有设备，需安装一加7 Pro fastboot驱动，方法自寻。

输入命令fastboot oem unlock，手机通过音量键选择unlock，电源键确定后进行解锁，等待手机重启进入系统（开机可跳过连接网络，省时间）。

重启后进入开发者选项，“允许OEM解锁”这一项是开启状态，且为灰色不可更改；再查看系统版本为氧OS 11.0.8.1或11.0.9.1。

Step 4.本地安装氧OS 12.1。

在大侠阿木网盘下载氧OS 12.1 OTA包：https://yun.daxiaamu.com/OnePlus_Roms_2/%E4%B8%80%E5%8A%A07%20Pro/%E6%B0%A7OS%2012.1%20H.20/

将zip包放入sdcard根目录下，进入系统更新，右上角本地安装，选择此包，等待安装结束后重启系统。

重启后进入开发者选项，“允许OEM解锁”这一项是开启状态，且为灰色不可更改；再查看系统版本为氧OS 12。

二、刷入LineageOS 20.0

1.在https://download.lineageos.org/devices/guacamole/builds下载最新版本镜像。4个均需要下载，其中zip文件为系统镜像包，boot.img为Lineage专用recovery镜像，用于安装LineageOS、Gapps（可选）及Magisk（可选）；dtbo.img和vbmeta.img为附加分区，必须刷入。

2.手机usb连接到电脑，在开机状态下，命令行输入adb reboot bootloader进入fastboot模式。

3.刷入附加分区：

fastboot flash dtbo dtbo.img 

fastboot flash vbmeta vbmeta.img

刷入刚刚下载的LineageOS 专用的recovery：

fastboot flash boot boot.img

完成后，手机上通过音量键选择reboot recovery进入recovery模式。

4.格式化存储。在recovery界面点击Factory Reset，再点Format data / factory reset，再点确定（继续）。

5.安装LineageOS。下方显示success完成后返回主菜单，点击Apply Update，点击Apply from ADB。然后再电脑命令行输入

adb sideload lineage-20.0-20230319-nightly-guacamole-signed.zip

等待手机的安装，期间电脑命令行中显示的进度可能会停在47%，不用管等着就行。成功后会显示：Total xfer: 1.00x。

如果显示adb: failed to read command: Success 或者

adb: failed to read command: No error 或者

adb: failed to read command: Undefined error: 0

也都是正常现象，表明安装成功。如果你要安装Gapps，请勿重启系统，看6。

6.安装Gapps（可选）

【必做】！！返回recovery主菜单，点击Advanced，再点Reboot to Recovery，重启进入recovery模式！！

打开https://wiki.lineageos.org/gapps，选择对应LineageOS 20的Gapps：

由于众所周知的原因，可能直接点MindTheGapps加载不出来或无法下载，可以选择mirror。打开后选择13.0.0-arm64的版本下载：

下载完成后，在手机上点击Apply Update，点击Apply from ADB，然后在电脑命令行输入adb sideload MindTheGapps-13.0.0-arm64-20221025_100653.zip。期间手机会提示

Signature verification failed，是正常现象，点安装即可。安装完成后退回recovery主界面。

7.安装Magisk（可选）

在github下载magisk apk包，地址https://github.com/topjohnwu/Magisk/releases/download/v25.2/Magisk-v25.2.apk

之后点击Apply Update，Apply from ADB，在电脑命令行输入

adb sideload Magisk-v25.2.apk

期间手机会提示Signature verification failed，是正常现象，点安装即可。安装完成后退回主界面，可以点击Reboot system now进入系统。

进入系统后，应用中会有一个残缺的Magisk图标，先别打开Magisk。确保手机能够科学上网后（Magisk需要），点击Magisk图标，会提示你安装不完整需要更新，点击确定。授予Magisk安装应用的权限后继续安装。

安装后点击图标，再次提示安装不完整，点击ok，5秒后重启进行安装。

进入系统后再次打开Magisk就安装成功了。可选择以Zygisk模式安装，后续安装shamiko、lsposed等模块。