在以下设备上安装 LineageOS
Walmart onn. TV Box 4K (2021)

基本要求

1. 在实际操作之前，请至少通读一遍说明，以避免因遗漏任何步骤而导致问题！
2. 确保您的计算机安装了 adb 和 fastboot。 设置说明可以在这里找到。
3. 在您的设备上启用USB 调试。
4. 使用原厂操作系统至少启动一次您的设备，并检查所有功能。
5. 从您的设备中移除所有 Google 帐户，以避免“出厂重置保护”
6. LineageOS 按“现状”提供，不提供任何担保。 尽管我们尝试验证 一切正常，但您需要自行承担安装风险！

固件要求

这些说明仅适用于尚未更新到 2024 年 4 月安全补丁级别之后的 2024 年 8 月 OTA 或更高版本的设备。

如果您的设备已更新到此版本之后，则无法解锁引导程序，并且您无法在该设备上运行 LineageOS。

降级到旧版本不是一个可行的选项。

您可以在“设置”应用程序的“系统”、“关于”选项卡下，标记为“安全补丁级别”的位置查看。

如果您尚未设置您的设备，请勿进行设置以检查版本或切换 OEM 解锁，只需继续按照安装说明进行操作，因为设置过程会强制更新设备。 请跳过此页面和下一页，直接转到强制解锁引导程序并从那里开始操作。

如果您的设备已经过了设置屏幕，并且是 2024 年 4 月 OTA 或更早的版本，您可以使用下面的“下一步”按钮继续。

解锁引导程序

1. 如果存在，请在设备设置的开发者选项中启用 OEM 解锁。
2. 通过 USB 将设备连接到您的 PC。
3. 在计算机上，打开命令提示符（在 Windows 上）或终端（在 Linux 或 macOS 上）窗口，并键入

   adb -d reboot bootloader
   

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

   • 运行 adb reboot bootloader。
4. 一旦设备进入 fastboot 模式，通过键入以下命令验证您的 PC 是否找到它

   fastboot devices
   

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

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

   fastboot oem 'setenv lock 10100000;saveenv;save' && fastboot reboot bootloader && fastboot flashing unlock
   

   info_outline

   注意： 此时，设备可能会显示屏幕提示，需要交互才能继续解锁引导程序的过程。 请采取设备要求您执行的任何操作以继续。
6. 如果设备没有自动重启，请重启它。 现在应该已解锁。
7. 由于设备完全重置，您需要重新启用 USB 调试才能继续。

强制解锁引导程序

1. 运行以下命令以确定设备当前的引导程序锁定状态

    fastboot getvar unlocked
   

2. 如果您的设备报告 unlocked: yes，请滚动到此步骤的末尾，并继续执行标记为“刷写 dtb 和 dtbo 分区”的下一步。
3. 如果您的设备报告 unlocked: no，请关闭设备电源，并通过按住设备侧面的配对按钮并连接到您的主机来将其启动到烧录模式。
4. 在您的主机上运行以下命令

    wget https://github.com/khadas/utils/raw/master/aml-flash-tool/tools/linux-x86/update
    chmod +x update
    sudo ./update bulkcmd "setenv lock 10100000"
    sudo ./update bulkcmd "saveenv"
    sudo ./update bulkcmd "reboot bootloader"
    rm ./update
   

   输出应类似于以下内容

    AmlUsbBulkCmd[setenv lock 10101000]
    [AmlUsbRom]Inf:bulkInReply success
    AmlUsbBulkCmd[saveenv]
    [AmlUsbRom]Inf:bulkInReply success
    AmlUsbBulkCmd[reboot bootloader]
    [AmlUsbRom]Err:return len=0 < strLenBusy 11
    [AmlUsbRom]Inf:bulkInReply
    ERR: AmlUsbBulkCmd failed!
   

   info_outline

   注意： 请注意，最后一个命令的失败是预期的，您的设备现在应该已启动到 fastboot 模式。
5. 重新运行以下命令以确定设备当前的引导程序锁定状态

    fastboot getvar unlocked
   

刷写 dtb 和 dtbo 分区

1. 从这里下载 dtb.img 和 dtbo.img 文件。
2. 将设备重启到 bootloader 模式
   • 运行 adb reboot bootloader。
3. 通过运行以下命令将下载的镜像文件刷写到您的设备

    fastboot flash dtb dtb.img
    fastboot flash dtbo dtbo.img
   

使用 fastboot 安装 Lineage Recovery

1. 下载Lineage Recovery。 只需下载最新的 recovery 文件，名为 recovery.img。
   警告

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

   adb -d reboot bootloader
   

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

   • 运行 adb reboot bootloader。
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 以验证安装。

   • fastboot boot recovery.img
     

   info_outline

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

从 recovery 安装 LineageOS

1. 下载您想要安装的 LineageOS zip 文件，或者自行构建软件包。
2. 如果您不在 recovery 中，请重启进入 recovery
3. 现在点击 出厂重置，然后点击 格式化 data / 恢复出厂设置 并继续格式化过程。 这将移除加密并删除内部存储中存储的所有文件，以及格式化您的缓存分区（如果您有）。
4. 返回主菜单。
5. 侧载 LineageOS .zip 软件包，但在您阅读/遵循其余说明之前不要重启！
   • 在设备上，选择“应用更新”，然后选择“从 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. 点击 应用更新，然后 从 ADB 应用，然后 adb -d sideload filename.zip，针对所有需要的软件包按顺序执行。
   当出现显示 Signature verification failed 的屏幕时，点击 是。 这是预期的，因为附加组件未使用 LineageOS 的官方密钥签名！

全部设置完成！

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

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

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

下一步是什么？

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