在以下设备上升级 LineageOS
Google Pixel XL

基本要求

1. 在实际操作之前，请至少通读一遍说明，以避免因遗漏步骤而产生任何问题！
2. 您实际上是想将您的设备升级到最新版本 - 如果您希望降级到 LineageOS 的早期版本，请按照您的设备说明进行首次安装 LineageOS。

手动升级 LineageOS

更新程序应用不支持从一个 LineageOS 版本升级到另一个版本，并且会阻止安装任何不同版本的更新。手动升级需要与首次安装 LineageOS 类似的步骤。

1. 下载您想要安装的 LineageOS 安装包，或者构建您自己的软件包。
2. 如果您当前正在使用（或现在想要使用）应用程序包附加组件，例如 Google 应用，您有以下选项
   • 继续使用它们：立即下载合适的版本（使用 arm64 架构）
   • 移除它们：您只能通过执行恢复出厂设置来做到这一点，这也将删除您的所有数据。
   • 开始使用它们：您只能通过执行恢复出厂设置来做到这一点，这也将删除您的所有数据。 立即下载合适的版本（使用 arm64 架构）
3. 确保您的计算机具有可用的 adb。设置说明可以在这里找到。
4. 在您的设备上启用USB 调试。
5. 此外，如果您使用的是 LineageOS 16.0 或更低版本，请打开“设置”，然后点击“系统”，然后点击“开发者选项”，然后选择“Root 访问权限选项”，最后选择“仅 ADB”。现在，运行 adb -d root
6. 通过运行 adb -d reboot recovery 重启进入 Recovery 模式，或者通过执行以下操作
   • 在设备关机状态下，按住 音量减小 + 电源 键。然后使用菜单选择Recovery 模式。
7. 如果您的设备尚未重新分区，请选择 “Advanced”（高级），然后选择 “Reboot to Bootloader”（重启到 Bootloader）。
   info_outline

   注意： 如果您不确定您的设备是否已重新分区，则很可能尚未重新分区！
8. 下载 Lineage Recovery。只需下载最新的 recovery 文件，名为 boot.img。
   warning

   重要提示： 其他 Recovery 可能不适用于安装或更新。我们强烈建议使用上面链接的 Recovery！
9. 现在，使用音量按钮选择 “Advanced”（高级），然后选择 “Enable ADB”（启用 ADB）。
10. 如果您的设备尚未处于 fastboot 模式，请在计算机上打开命令提示符（在 Windows 上）或终端（在 Linux 或 macOS 上）窗口，然后输入

    adb -d reboot bootloader
    

    您也可以通过按键组合启动进入 fastboot 模式

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

    fastboot devices
    

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

    • 在 Windows 上：确保设备管理器中显示的设备没有三角形。尝试其他驱动程序，直到上面的命令有效！
    • 在 Linux 或 macOS 上：如果您看到 no permissions fastboot，请尝试以 root 身份运行 fastboot。当输出为空时，请检查您的 USB 数据线（最好使用 USB Type-A 2.0 数据线或 USB 集线器）和端口！
    check

    提示： 某些设备在 bootloader 模式下 USB 支持存在错误，如果您在使用诸如 fastboot getvar ...、fastboot boot ...、fastboot flash ... 等命令时看到 fastboot 卡住且没有输出，您可能需要尝试不同的 USB 端口（最好是 USB Type-A 2.0 端口）或 USB 集线器。
12. 通过输入以下命令在您的设备上刷入 recovery

    fastboot flash boot boot.img
    

    info_outline

    注意： 过时的 fastboot 版本放弃了对旧版 A/B 分区的支持，因此如果您尝试刷入 boot，它可能会尝试刷入到 boot__a / boot__b 而不是 boot_a / boot_b。在这种情况下，您必须将 fastboot 更新到高于或等于 31.0.2 的版本。或者，您可以根据 fastboot 未能刷入的分区手动指定要刷入的分区。例如，如果 fastboot 未能刷入到 boot__a，您必须刷入到 boot_a。
13. 现在重启进入 recovery 以验证安装。
    • 使用菜单导航到并选择 Recovery 选项。
    info_outline

    注意： 如果您的 recovery 没有显示 LineageOS 标志，您意外地启动进入了错误的 recovery。请从本节顶部重新开始！

EFS/Persist 备份

1. 如果您不在 recovery 模式下，请重启进入 recovery 模式
   • 在设备关机状态下，按住 音量减小 + 电源 键。然后使用菜单选择Recovery 模式。
2. 现在，使用音量按钮选择 “Advanced”（高级），然后选择 “Enable ADB”（启用 ADB）。
3. 现在打开终端 (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
4. 现在从同一个终端/PowerShell 中，运行
   • adb -d pull /tmp/modemst1.img
   • adb -d pull /tmp/modemst2.img
   • adb -d pull /tmp/persist.img

重新分区

1. 从 此处 下载适用于 32 GB 型号的可刷写重新分区脚本，从 此处 下载适用于 128 GB 型号的脚本。
2. 将下载的 zip 文件重命名为 repartition.zip。
3. 在您的设备屏幕上，选择 “Apply Update”（应用更新），然后选择 “From ADB”（从 ADB）。
4. 从您的终端/PowerShell 中，运行 adb -d sideload /path/to/repartition.zip，将 /path/to/ 替换为您下载重新分区 zip 文件的路径。
   info_outline

   注意： 所讨论的重新分区脚本包未使用 LineageOS 的官方密钥签名，因此当它被 sideload 时，Lineage Recovery 将显示一个屏幕，提示 Signature verification failed（签名验证失败），这是预期的，请点击 Yes（是）。
   warning

   警告： 此步骤可能需要长达 5 分钟，请确保在此期间您的 USB 连接/电源没有中断。

5. 设备将完成重新分区过程，并在屏幕上显示 Done!（完成！），此时请选择 “Advanced”（高级），然后选择 “Reboot to Recovery”（重启到 Recovery），然后继续安装过程。

6. 擦除您的数据分区（通常名为 “Wipe”（擦除）、“Format”（格式化）或 “Factory reset”（恢复出厂设置））

   warning

   警告： 如果没有此步骤，您的设备将无法在新版本上启动！
   warning

   警告： 此步骤将擦除您的个人数据并删除任何用户安装的应用。如果这些对您很重要，那么您应该在执行升级之前备份它们。
7. 点击 Advanced（高级），然后点击 Enable ADB（启用 ADB）。
8. 运行 adb -d reboot sideload。
   warning

   重要提示： 设备可能会重启到一个空白的黑屏，不要害怕，这是某些 Recovery 上的已知错误，请继续按照说明操作。
9. 运行 adb -d sideload /path/to/zip（插入您的 LineageOS 包的路径）。
   check

   提示： 通常，adb 将报告 Total xfer: 1.00x，但在某些情况下，即使该过程成功，输出也会在 47% 处停止并报告 adb: failed to read command: Success（adb：读取命令失败：成功）。在某些情况下，它将报告 adb: failed to read command: No error（adb：读取命令失败：无错误）或 adb: failed to read command: Undefined error: 0（adb：读取命令失败：未定义错误：0），这也是正常的。
10. （可选）：如果您想安装任何附加组件，请点击 Advanced（高级），然后点击 Reboot to Recovery（重启到 Recovery），然后在您的设备重启后，点击 Apply Update（应用更新），然后点击 Apply from ADB（从 ADB 应用），然后依次 adb -d sideload /path/to/zip 刷入这些软件包。
    info_outline

    注意： 如果您之前在设备上安装了任何 Google 应用附加包，您必须在 Android 首次启动之前安装更新的软件包！如果您没有安装 Google 应用，您必须擦除 Data 分区（或执行恢复出厂设置）才能安装它们。
    info_outline

    注意： 附加组件未使用 LineageOS 的官方密钥签名，因此当它们被 sideload 时，Lineage Recovery 将显示一个屏幕，提示 Signature verification failed（签名验证失败），这是预期的，请点击 Continue（继续）。
11. 一旦您成功安装了所有内容，请点击屏幕左上角的后退箭头，然后点击 “Reboot system now”（立即重启系统）。

获取帮助

在您仔细检查您是否精确地按照步骤操作，没有跳过任何步骤，但仍然有疑问或遇到困难时，请随时在我们的 subreddit 或 Libera.Chat 上的 #LineageOS 中提问。