在以下设备上安装 LineageOS
OnePlus 8

基本要求

1. 在实际操作之前，至少通读一遍这些说明，以避免因遗漏任何步骤而导致的问题！
2. 确保你的电脑安装了 adb 和 fastboot。 设置说明可以在 这里 找到。
3. 在你的设备上启用 USB 调试。
4. 确保你的型号是以下型号之一（必须完全匹配！）
   • IN2010
   • IN2011
   • IN2013
   • IN2015
5. 至少启动一次设备的 stock OS，并检查所有功能。
   警告

   警告： 确保你可以发送和接收短信，以及拨打和接听电话（也包括通过 Wi-Fi 和 LTE，如果可用），否则在 LineageOS 上也无法工作！ 此外，某些设备需要先在 stock 系统上使用一次 VoLTE/VoWiFi 来配置 IMS。
6. 从你的设备上移除所有 Google 帐户，以避免 “Factory reset protection”（恢复出厂设置保护）
7. LineageOS 按 “现状” 提供，不提供任何 гарантии。 虽然我们尝试验证 所有功能都正常工作，但你仍需自行承担安装风险！

检查正确的固件

在你的设备上安装需要先安装特定的 固件 版本才能继续。

• 固件指的是设备特定的镜像集合，它包含在 stock OS 中并由其更新
• 此设备的 LineageOS 构建版本需要先安装 Android 13 版本的 stock OS，然后才能按照安装指南进行操作
• 请确保你检查的是 Android 版本，而不是厂商 OS 版本
• 使用另一个自定义 ROM，包括相同 LineageOS 版本的非官方构建版本，并不能确保已满足此要求
• 请多次重新阅读本节，以充分理解这些要求

在安装前未能安装正确的固件版本可能会导致 LineageOS 安装失败、安装后出现意外崩溃或对你的设备造成永久性损坏！

解锁引导加载程序

1. 如果存在，请在设备设置的开发者选项中启用 OEM 解锁。
2. 通过 USB 将设备连接到你的 PC。
3. 在电脑上，打开命令提示符窗口（在 Windows 上）或终端窗口（在 Linux 或 macOS 上），然后输入

   adb -d reboot bootloader
   

   你也可以通过按键组合启动到 fastboot 模式

   • 在设备关机状态下，按住 音量上 + 音量下 + 电源 键。
4. 一旦设备进入 fastboot 模式，通过输入以下命令验证你的 PC 是否找到它

   fastboot devices
   

   如果你没有得到任何输出或出现错误

   • 在 Windows 上：确保设备管理器中显示的设备没有三角形。 尝试其他驱动程序，直到上述命令有效！
   • 在 Linux 或 macOS 上：如果你看到 no permissions fastboot，请尝试以 root 身份运行 fastboot。 当输出为空时，检查你的 USB 数据线和端口！
5. 现在输入以下命令来解锁引导加载程序

   fastboot oem unlock
   

   info_outline

   注意： 此时，设备可能会显示屏幕提示，需要交互才能继续解锁引导加载程序的过程。 请按照设备的要求采取任何操作以继续。
6. 如果设备没有自动重启，请重启它。 现在应该已解锁。
7. 由于设备完全重置，你需要重新启用 USB 调试才能继续。

刷写额外的分区

1. 从 此处 下载以下文件。
   • dtbo.img
   • vbmeta.img
2. 关闭设备电源，并将其启动到 bootloader 模式
   • 在设备关机状态下，按住 音量上 + 音量下 + 电源 键。
3. 通过输入以下命令将下载的镜像文件刷写到你的设备

   fastboot flash dtbo dtbo.img
   fastboot flash vbmeta vbmeta.img
   

使用 fastboot 安装 Lineage Recovery

1. 下载 Lineage Recovery。 只需下载最新的 recovery 文件，名为 recovery.img。
   警告

   重要提示： 其他 recovery 可能无法用于安装或更新。 我们强烈建议使用上面链接的 recovery！
2. 将 recovery 刷写到你的设备上

   fastboot flash recovery recovery.img
   

3. 现在重启进入 recovery 以验证安装。
   • 使用菜单导航到并选择 Recovery 选项。
   info_outline

   注意： 如果你的 recovery 没有 显示 LineageOS 徽标，你可能意外启动到了错误的 recovery。 请从本节顶部重新开始！

从 recovery 安装 LineageOS

1. 下载你要安装的 LineageOS zip 文件，或 自行构建 软件包。
2. 如果你不在 recovery 中，请重启进入 recovery
   • 在设备关机状态下，按住 音量下 + 电源 键。
3. 现在点击 Factory Reset（恢复出厂设置），然后点击 Format data / factory reset（格式化数据/恢复出厂设置）并继续格式化过程。 这将移除加密并删除存储在内部存储中的所有文件，并格式化你的缓存分区（如果你有的话）。
4. 返回主菜单。
5. 侧载 LineageOS .zip 软件包，但在你阅读/遵循剩余的说明之前，不要重启！
   • 在设备上，选择 “Apply Update”（应用更新），然后选择 “Apply from ADB”（从 ADB 应用更新）以开始侧载。
   • 在主机上，使用以下命令侧载软件包：adb -d sideload filename.zip。
     检查

     提示： 在软件包安装完成后，recovery 会通知你需要重启到 recovery 以安装附加组件。 如果你想这样做，请选择 “Yes”（是），否则选择 “No”（否）。
     检查

     提示： 通常，adb 会报告 Total xfer: 1.00x，但在某些情况下，即使该过程成功，输出也会在 47% 处停止并报告 adb: failed to read command: Success。 在某些情况下，它会报告 adb: failed to read command: No error 或 adb: failed to read command: Undefined error: 0，这也是正常的。

安装附加组件

1. 点击 Apply Update（应用更新），然后点击 Apply from ADB（从 ADB 应用更新），然后对所有需要的软件包按顺序执行 adb -d sideload filename.zip。
   当屏幕显示 Signature verification failed（签名验证失败）时，点击 Yes（是）。 这是预期的，因为附加组件未使用 LineageOS 的官方密钥签名！

全部设置完成！

一旦你成功安装了所有内容，你现在可以首次将你的设备重启进入操作系统！

• 点击屏幕左上角的后退箭头，然后点击 “Reboot system now”（立即重启系统）。

如果你想知道下一步该做什么，请继续阅读，否则，请享受你的新 LineageOS 安装。

下一步是什么？

• 如果你正在考虑重新锁定你的引导加载程序，请参阅我们关于此的 FAQ（常见问题解答）。
• 如果你的设备在每次启动时都显示警告 - 你对此无能为力，只能忽略它。
• 请不要使用任何方法卸载系统应用。 我们已经只发布了最少量的应用，这样做可能会破坏你的系统。 警告你！
• 我们不支持任何 root 方法，因此不会在我们的任何平台上提供 root 方面的支持
• LineageOS 是 Android。 它像任何其他 Android 设备一样支持应用，但应用可能会选择阻止你使用它们。 请返回你的 设备怪癖部分 并阅读关于 “设备完整性” 的内容。