在以下设备安装 LineageOS
Motorola moto g5s

基本要求

1. 在实际操作之前，请至少通读一遍说明，以避免因遗漏步骤而导致任何问题！
2. 确保您的计算机已安装 `adb` 和 `fastboot`。 设置说明可以在这里找到。
3. 在您的设备上启用USB 调试。
4. 确保您的型号是以下型号之一（需要完全匹配！）：
   • XT1790
   • XT1791
   • XT1792
   • XT1793
   • XT1794
   • XT1795
   • XT1797
   • XT1799-2
5. 至少启动一次设备的 stock OS，并检查所有功能。
   警告

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

检查正确的固件

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

• 固件指的是设备特定的镜像集合，这些镜像包含在 stock OS 中并由其更新
• 此设备的 LineageOS 构建版本要求在遵循安装指南之前安装 Android 8.1 版本的 stock OS
• 请确保您检查的是 Android 版本，而不是供应商 OS 版本
• 使用另一个自定义 ROM，包括同一版本 LineageOS 的非官方构建版本，并不能确保已满足此要求
• 请根据需要多次重读本节，以充分理解这些要求

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

解锁 Bootloader

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. 按照 Motorola 支持 的说明解锁您的 bootloader。

   info_outline

   注意： 一些较新的 Motorola 设备有一个等待期，之后您才能在开发者选项中启用 “OEM 解锁” 选项。 这有时可能需要长达一周的时间。
   info_outline

   注意： 如果您的设备不受 Motorola Bootloader Unlock 网站支持，您或许可以使用其他 bootloader 解锁方法，例如 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 安装。

下一步是什么？

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