在以下设备上安装 LineageOS
HTC One (M8)

警告： 提供的说明适用于 LineageOS 17.1。只有您精确地遵循每个章节和步骤，这些说明才会有效。
如果在任何环节失败，请不要继续！

基本要求

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

解锁 Bootloader

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

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

如果存在，请在设备设置中的开发者选项中启用 OEM 解锁。
通过 USB 将设备连接到您的电脑。
在计算机上，打开命令提示符（在 Windows 上）或终端（在 Linux 或 macOS 上）窗口，并输入
```
adb -d reboot bootloader
```
您也可以通过按键组合启动进入 fastboot 模式
- 在设备关机状态下，按住 音量下 + 电源 键直到出现 Bootloader 界面，然后松开按键。使用音量键滚动到“FASTBOOT”，然后按 电源 键选择。
设备进入 fastboot 模式后，输入以下命令验证您的电脑是否找到设备
```
fastboot devices
```
如果您没有得到任何输出或出现错误
- 在 Windows 上：确保设备管理器中设备没有出现三角形警告标志。尝试其他驱动程序，直到上述命令工作为止！
- 在 Linux 或 macOS 上：如果您看到 no permissions fastboot，请尝试以 root 身份运行 fastboot。如果输出为空，请检查您的 USB 数据线和端口！
现在输入以下命令以获取您的 Bootloader 解锁令牌
```
fastboot oem get_identifier_token
```
访问 HTCDev Bootloader Unlock 网站，并按照那里的说明获取您的解锁密钥并解锁您的 Bootloader。如果您的设备未出现在下拉列表中，请选择所有其他支持的型号。

注意： 如果您的设备不受 HTCDev Bootloader Unlock 网站支持，您或许可以使用其他 Bootloader 解锁方法，例如 SunShine，但它们仅支持部分设备/固件。
如果设备没有自动重启，请重启它。它现在应该已解锁。
由于设备完全重置，您需要重新启用 USB 调试才能继续。

使用 `fastboot` 安装自定义 Recovery

下载一个自定义 Recovery - 您可以下载 TWRP。只需下载最新的 Recovery 文件，文件名类似于 twrp-x.x.x-x-m8.img，并将其重命名为 recovery.img。
重要提示： 其他 Recovery 可能不适用于安装或更新。我们强烈建议使用上面链接的 Recovery！
如果您的设备尚未连接到电脑，请通过 USB 连接。
如果您的设备尚未处于 fastboot 模式，请在计算机上打开命令提示符（在 Windows 上）或终端（在 Linux 或 macOS 上）窗口，并输入
```
adb -d reboot bootloader
```
您也可以通过按键组合启动进入 fastboot 模式
- 在设备关机状态下，按住 音量下 + 电源 键直到出现 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 recovery recovery.img
```
现在重启进入 Recovery 以验证安装。不要重启进入现有的操作系统，因为它会覆盖您刚刚安装的 Recovery！
- 在设备关机状态下，按住 音量下 + 电源 键直到出现 Bootloader 界面，然后松开按键。使用音量键滚动到“RECOVERY”，然后按 电源 键选择。
  
  注意： 如果您无法关闭设备，请尝试长按组合键（如果在上面的说明中使用过）直到设备重启，并按照上面的说明操作

从 Recovery 安装 LineageOS

构建 LineageOS 安装包。
如果您不在 Recovery 模式，请重启进入 Recovery 模式
- 在设备关机状态下，按住 音量下 + 电源 键直到出现 Bootloader 界面，然后松开按键。使用音量键滚动到“RECOVERY”，然后按 电源 键选择。
现在点击 Wipe（清除）。
现在点击 Format Data（格式化数据） 并继续格式化过程。这将移除加密并删除内部存储中的所有文件。
返回上一个菜单并点击 Advanced Wipe（高级清除），然后选择 Cache（缓存） 和 System（系统） 分区，然后 Swipe to Wipe（滑动以清除）。
Sideload LineageOS .zip 包
- 在设备上，选择 “Advanced（高级）”、“ADB Sideload（ADB Sideload）”，然后滑动以开始 Sideload。
- 在主机上，使用以下命令 Sideload 包：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，这也是正常的。

安装附加组件

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

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

对所有需要的软件包按顺序重复上述 Sideload 步骤。

一切就绪！

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

运行 adb -d reboot。

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

警告： 根据您使用的 Recovery 不同，您可能会被提示安装其他应用和服务。我们强烈建议您选择不安装这些，因为它们可能会导致您的设备卡在启动循环中，并可能尝试访问或损坏您的数据。

如果您想知道接下来的步骤，请继续阅读，否则，请享受您新安装的 LineageOS。

下一步是什么？

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

获取帮助

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

在以下设备上安装 LineageOSHTC One (M8)