在以下设备上安装 LineageOS
Motorola moto g5

基本要求

1. 在实际操作之前，请至少通读一遍说明，以避免因遗漏步骤而产生任何问题！
2. 确保您的计算机安装了 adb 和 fastboot。 安装说明可以在这里找到。
3. 在您的设备上启用USB 调试。
4. 确保您的型号是以下型号之一（需要完全匹配！）：
   • XT1670
   • XT1671
   • XT1672
   • XT1675
   • XT1676
   • XT1677
5. 至少启动一次带有原厂操作系统的设备，并检查所有功能。
   警告

   警告： 确保您可以发送和接收短信，以及拨打和接听电话（也包括通过 WiFi 和 LTE，如果可用），否则在 LineageOS 上也无法工作！ 此外，某些设备需要在原厂系统上使用 VoLTE/VoWiFi 一次以配置 IMS。
6. 从您的设备中移除所有 Google 帐户，以避免“出厂重置保护”
7. LineageOS 按原样提供，不提供任何担保。 尽管我们尝试验证所有功能都正常工作，但您需要自行承担安装风险！

检查正确的固件

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

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

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

解锁引导加载程序

1. 通过 USB 将设备连接到您的 PC。
2. 在计算机上，打开命令提示符窗口（在 Windows 上）或终端窗口（在 Linux 或 macOS 上），然后输入

   adb -d reboot bootloader
   

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

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

   fastboot devices
   

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

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

4. 按照摩托罗拉支持上的说明解锁您的引导加载程序。

   info_outline

   注意： 一些较新的摩托罗拉设备在您可以启用开发者选项中的 OEM 解锁 选项之前，有一个等待期。 有时可能需要长达一周的时间。
   info_outline

   注意： 如果您的设备不受摩托罗拉引导加载程序解锁网站的支持，您或许可以使用像 SunShine 这样的替代引导加载程序解锁方法，尽管它们只支持某些设备/固件。
5. 由于设备完全重置，您需要重新启用 USB 调试才能继续。

使用 fastboot 安装 Lineage Recovery

1. 构建 LineageOS 安装包。 Recovery 将作为其中的一部分构建！
   警告

   重要提示： 其他 Recovery 可能不适用于安装或更新。 我们强烈建议使用上面链接的 Recovery！
2. 如果您的设备尚未通过 USB 连接到您的 PC，请连接。
3. 如果您的设备尚未处于 fastboot 模式，请在计算机上打开命令提示符窗口（在 Windows 上）或终端窗口（在 Linux 或 macOS 上），然后输入

   adb -d reboot bootloader
   

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

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

   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 集线器。
5. 将 Recovery 刷入您的设备

   fastboot flash recovery recovery.img
   

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

   注意： 如果您的 Recovery 没有显示 LineageOS 徽标，您不小心启动进入了错误的 Recovery。 请从本节顶部重新开始！

从 Recovery 安装 LineageOS

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

     提示： 通常，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 -d sideload filename.zip 命令，按顺序进行。
   当出现提示 Signature verification failed 的屏幕时，点击 Yes。 这是预期行为，因为附加组件未使用 LineageOS 的官方密钥签名！

一切就绪！

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

• 点击屏幕左上角的后退箭头，然后点击“Reboot system now”。

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

下一步是什么？

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