====== LineageOS 系统 OTA 升级并保留 Magisk(Root)的操作指南 ====== 在现代 Android 的 A/B 双分区机制下,LineageOS 的系统更新会默认写入当前未使用的闲置分区(Inactive Slot)。如果在系统 OTA 完成后直接重启,设备将从已写入新系统但未配置 Root 的干净分区启动,导致 Magisk 权限丢失。 为实现无缝升级并保留 Root 权限,应采用「未激活槽位注入法」。本指南适用于日常小版本或安全补丁更新。 ===== 🛠️ 前置条件与风险提示 ===== - **适用架构**:设备必须支持 **A/B 分区结构**(近年发布的主流设备均支持)。 - **升级限制**:此方法**仅适用于同版本内的增量或全量 OTA 更新**。若涉及跨 Android 大版本升级(如从 LineageOS 20 升级至 21),必须进入 Recovery 手动卡刷,不可使用此方法。 - **操作核心**:在升级流程结束前,**绝对不可触发系统的自动重启**。 ===== 📋 标准化操作流程 ===== * 触发系统 OTA 更新(常规下载阶段) - 依次进入手机的「设置」→「系统」→「更新」(Updater)。 - 检查并下载最新的 LineageOS 固件包,点击**「安装」**。此时系统会在后台将新固件写入未激活的分区槽位。 * 挂起系统重启指令(关键红线阶段) - 待固件写入完毕后,系统更新界面会弹出「重启」提示。 - **此时绝对不要点击重启。** 直接返回手机桌面。 * 利用 Magisk 注入未激活分区(权限留存阶段) - 打开 **Magisk App**,点击第一栏 Magisk 选项右侧的**「安装」**(Install)。 - 在安装选项列表中,选择**「安装到未使用的槽位 (OTA 后)」**(Install to Inactive Slot (After OTA))。 * 执行修补与安全重启(流程完成阶段) - 点击**「开始」**(Let's go),Magisk 将自动抓取并修补另一个分区的 boot.img 镜像。 - 等待日志输出结束并显示 **All done!**(全部完成)后,点击 Magisk 的**「重启」**(Reboot)按钮。 ===== ⚠️ 异常情况处理(Bootloop 应急) ===== 若重启后设备未能进入系统,卡在 LineageOS 启动动画(俗称卡第一屏): - **恢复原生启动分区**:长按 **电源键 + 音量上键** 强制关机,并进入 Lineage Recovery 模式。 - **覆盖错误补丁**:通过电脑执行 %%adb sideload lineageos_固件名.zip%%,将干净的官方固件重新刷入该分区。此操作会覆盖掉导致故障的 Magisk 补丁,确保系统优先正常开机。 - **重新提取修补**:顺利开机进入系统后,再通过提取当前固件的 %%boot.img%% 发送至手机端 Magisk 进行手动修补,并利用 Fastboot 模式重新刷入。 {{tag>LineageOS Magisk Root OTA Android 刷机 A/B分区}}