在以下设备上安装 LineageOS
Google Pixel XL

marlin

警告： 提供的说明适用于 LineageOS 22.1。只有您精确地遵循每个部分和步骤，这些说明才会有效。
在发生错误后不要继续！

基本要求

在实际操作之前，请至少通读一遍说明，以避免因遗漏任何步骤而导致问题！
确保您的电脑安装了 adb 和 fastboot。安装说明可以在这里找到。
在您的设备上启用 USB 调试。
使用原厂操作系统至少启动您的设备一次，并检查所有功能。
警告： 确保您可以发送和接收短信，以及拨打和接听电话（也包括通过 WiFi 和 LTE，如果可用），否则在 LineageOS 上也无法工作！此外，某些设备需要先在原厂系统上使用 VoLTE/VoWiFi 一次以配置 IMS。
从您的设备中移除所有 Google 帐户，以避免“出厂重置保护”
LineageOS 按“现状”提供，不提供任何担保。尽管我们尝试验证一切正常，但您需要自行承担安装风险！

解锁引导加载程序

注意： 以下步骤每个设备只需运行一次。

警告： 解锁引导加载程序将擦除您设备上的所有数据！在继续之前，请确保您要保留的数据已备份到您的电脑和/或您的 Google 帐户或同等位置。请注意，一旦安装 LineageOS，可能无法访问三星和摩托罗拉备份等 OEM 备份解决方案。

如果存在，请在设备设置中的开发者选项中启用 OEM 解锁。
通过 USB 将设备连接到您的电脑。
在电脑上，打开命令提示符（在 Windows 上）或终端（在 Linux 或 macOS 上）窗口，然后输入
```
adb -d reboot bootloader
```
您也可以通过按键组合启动进入 fastboot 模式
- 在设备关机状态下，按住 音量减小 + 电源。
一旦设备进入 fastboot 模式，通过输入以下命令验证您的电脑是否找到它
```
fastboot devices
```
如果您没有得到任何输出或错误
- 在 Windows 上：确保设备管理器中显示的设备没有三角形。尝试其他驱动程序，直到上述命令有效！
- 在 Linux 或 macOS 上：如果您看到 no permissions fastboot，请尝试以 root 身份运行 fastboot。当输出为空时，请检查您的 USB 数据线和端口！
现在输入以下命令来解锁引导加载程序
```
fastboot flashing unlock
```
注意： 此时，设备可能会显示屏幕提示，需要交互才能继续解锁引导加载程序的过程。请按照设备要求执行任何操作以继续。
如果设备没有自动重启，请重启它。它现在应该已解锁。
由于设备完全重置，您需要重新启用 USB 调试才能继续。

使用 `fastboot` 安装 Lineage Recovery

下载 Lineage Recovery。只需下载最新的 recovery 文件，名为 boot.img。
重要提示： 其他 recovery 模式可能不适用于安装或更新。我们强烈建议使用上面链接的 recovery 模式！
如果您的设备尚未连接到电脑，请通过 USB 连接。
如果您的设备尚未处于 fastboot 模式，请在电脑上打开命令提示符（在 Windows 上）或终端（在 Linux 或 macOS 上）窗口，然后输入
```
adb -d reboot bootloader
```
您也可以通过按键组合启动进入 fastboot 模式
- 在设备关机状态下，按住 音量减小 + 电源。
一旦设备进入 fastboot 模式，通过输入以下命令验证您的电脑是否找到它
```
fastboot devices
```
如果您没有得到任何输出或错误
- 在 Windows 上：确保设备管理器中显示的设备没有三角形。尝试其他驱动程序，直到上述命令有效！
- 在 Linux 或 macOS 上：如果您看到 no permissions fastboot，请尝试以 root 身份运行 fastboot。当输出为空时，请检查您的 USB 数据线（最好使用 USB Type-A 2.0 数据线或 USB 集线器）和端口！
提示： 某些设备在 bootloader 模式下 USB 支持存在错误，如果您在使用诸如 fastboot getvar ...、fastboot boot ...、fastboot flash ... 等命令时看到 fastboot 卡住且没有输出，您可能需要尝试不同的 USB 端口（最好是 USB Type-A 2.0 端口）或 USB 集线器。
将 recovery 刷入您的设备
```
fastboot flash boot boot.img
```
现在重启进入 recovery 模式以验证安装。
- 使用菜单导航并选择 Recovery 选项。
注意： 如果您的 recovery 模式没有显示 LineageOS 徽标，您不小心启动进入了错误的 recovery 模式。请从本节顶部重新开始！

EFS/Persist 备份

警告： “EFS/Persist 备份”和“重新分区”步骤只需运行一次，如果您在安装指南期间运行了重新分区脚本，则无需再次执行。如果您不确定之前是否运行过，再次运行是无害的。

警告： 在进一步处理重新分区之前，我们强烈建议您使用 adb 备份 persist 和 EFS，否则您可能会丢失您的 IMEI/WIFI + BT mac 地址

如果您不在 recovery 模式下，请重启进入 recovery 模式
- 在设备关机状态下，按住 音量减小 + 电源。然后使用菜单选择恢复模式。
现在，使用音量按钮选择“高级”，然后选择“启用 ADB”。
现在打开终端 (Linux/macOS) 或 PowerShell (Windows)，运行 adb -d shell，然后在其中运行以下命令
- dd if=/dev/block/sdd9 of=/tmp/modemst1.img
- dd if=/dev/block/sdd10 of=/tmp/modemst2.img
- dd if=/dev/block/sdd3 of=/tmp/persist.img
- exit
现在从同一个终端/PowerShell 中，运行
- adb -d pull /tmp/modemst1.img
- adb -d pull /tmp/modemst2.img
- adb -d pull /tmp/persist.img

注意： 确保将这些文件存储在安全的地方，以防后续步骤失败。

重新分区

警告： 此步骤不是可选的，如果不先重新分区，设备将无法启动 LineageOS！

警告： 此过程将擦除设备上的所有数据，包括您的内部存储！

从此处下载适用于 32 GB 型号的可刷入重新分区脚本，从此处下载适用于 128 GB 型号的脚本。
将下载的 zip 文件重命名为 repartition.zip。
在您的设备屏幕上，选择“应用更新”，然后选择“从 ADB 应用”。
从您的终端/PowerShell 中，运行 adb -d sideload /path/to/repartition.zip，用您下载的重新分区 zip 文件的路径替换 /path/to/。
注意： 相关的重新分区脚本包未使用 LineageOS 的官方密钥签名，因此当它被 sideload 时，Lineage Recovery 将显示一个屏幕，显示 签名验证失败，这是预期的，请单击 是。

警告： 此步骤可能需要长达 5 分钟，请确保在此期间您的 USB 连接/电源未中断。
设备将完成重新分区过程，并在屏幕上显示 完成！，此时请选择“高级”，然后选择“重启到 Recovery 模式”，然后继续安装过程。

从 recovery 模式安装 LineageOS

下载您要安装的 LineageOS zip 文件或自行构建软件包。
如果您不在 recovery 模式下，请重启进入 recovery 模式
- 在设备关机状态下，按住 音量减小 + 电源。然后使用菜单选择恢复模式。
现在点击恢复出厂设置，然后点击格式化数据/恢复出厂设置并继续格式化过程。这将移除加密并删除内部存储中存储的所有文件，以及格式化您的缓存分区（如果您有）。
返回主菜单。
Sideload LineageOS .zip 软件包，但在您阅读/遵循其余说明之前请勿重启！
- 在设备上，选择“应用更新”，然后选择“从 ADB 应用”以开始 sideload。
- 在主机上，使用以下命令 sideload 软件包：adb -d sideload filename.zip。
  提示： 软件包安装完成后，recovery 模式会通知您需要重启到 recovery 模式才能安装附加组件。如果您想这样做，请选择“是”，否则选择“否”。
  
  提示： 通常，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，这也是正常的。

安装附加组件

注意： 如果您不想安装任何附加组件（例如 Google 应用），您可以跳过整个部分！

警告： 如果您想安装 Google 应用附加组件包（使用 arm64 架构），您可以从此处下载。此附加组件需要在首次启动进入 LineageOS 之前安装！

点击 应用更新，然后点击 从 ADB 应用，然后为所有需要的软件包依次执行 adb -d sideload filename.zip。
当出现显示 签名验证失败 的屏幕时，点击 是。这是预期的，因为附加组件未使用 LineageOS 的官方密钥签名！

一切就绪！

成功安装所有内容后，您现在可以首次将设备重启进入操作系统！

点击屏幕左上角的后退箭头，然后点击“立即重启系统”。

注意： 首次启动通常不超过 15 分钟，具体取决于设备。如果时间更长，您可能遗漏了某个步骤，否则请随时寻求帮助。

如果您想知道后续步骤，请继续，否则，请享受您新的 LineageOS 安装。

下一步是什么？

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

获取帮助

在您仔细检查您是否精确地遵循了步骤，没有跳过任何步骤但仍然有问题或遇到困难后，请随时在我们的 subreddit 或 Libera.Chat 上的 #lineageos 中提问。

在以下设备上安装 LineageOSGoogle Pixel XL