在以下设备上安装 LineageOS
Samsung Galaxy S9

基本要求

1. 在实际操作之前，请至少通读一遍说明，以避免因遗漏任何步骤而导致问题！
2. 确保您的计算机已安装 adb。设置说明请见此处。
3. 在您的设备上启用USB 调试。
4. 确保您的型号是以下型号之一（必须完全匹配！）
   • SM-G960F
   • SM-G960F/DS
   • SM-G960N
5. 至少启动一次搭载原厂操作系统的设备，并检查所有功能是否正常。
6. 从您的设备上移除所有 Google 帐户，以避免 “恢复出厂设置保护”。
7. LineageOS 按“现状”提供，不提供任何 гарантии。尽管我们尝试验证所有功能均可正常工作，但您需自行承担安装风险！

检查正确的固件

在您继续之前，您的设备需要安装特定版本的固件。

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

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

安装准备

三星设备配备了一种独特的启动模式，称为 “下载模式”，它与某些解锁 bootloader 的设备上的 “Fastboot 模式” 非常相似。Heimdall 是一款跨平台的开源工具，用于与三星设备上的下载模式进行交互。安装自定义 recovery 的首选方法是通过下载模式——无需也不需要 root 原厂固件。

1. 通过在 “设置” 应用的 “关于手机” 菜单中点击 “版本号” 选项来启用 “开发者选项”。
   • 在 “开发者选项” 菜单中，启用 “OEM 解锁”。
2. 下载并安装适用于您计算机操作系统的 Heimdall 套件的相应版本。
   • Windows：解压 Heimdall 套件 zip 文件，并记下包含 heimdall.exe 的新目录。您可以通过在该目录中打开命令提示符或 PowerShell 并运行 heimdall version 来验证 Heimdall 是否正常工作。
     • 如果您收到错误，请在您的计算机上安装Microsoft Visual C++ 2015-2019 Redistributable Package (x86)。
   • Linux：解压 Heimdall 套件 zip 文件，并记下包含 heimdall 的新目录。现在将 heimdall 复制到 $PATH 中的一个目录中，大多数发行版上的常见目录是 /usr/local/bin。例如 cp heimdall /usr/local/bin。您可以通过打开终端并运行 heimdall version 来验证 Heimdall 是否正常工作。
   • macOS：挂载 Heimdall 套件 DMG 文件。现在将 heimdall 拖到 DMG 文件中提供的 /usr/local/bin 符号链接中。您可以通过打开终端并运行 heimdall version 来验证 Heimdall 是否正常工作。
   info_outline

   注意：这些 Heimdall 套件发行版由 LineageOS 开发者 Nolen Johnson (npjohnson) 和 Jan Altensen (Stricted) 构建，因为官方 Heimdall 网站上发布的 Heimdall 套件可执行文件已过时，并且该仓库已基本被弃用。为了使其能够在现代操作系统上构建和运行，进行了修改。
3. 关闭设备电源，并将其启动到下载模式。
   • 在设备关机状态下，按住 音量减小 + Bixby + 电源 键。
   • 现在，点击屏幕上指示对应 “Continue（继续）” 的按钮，并将 USB 数据线插入设备。
4. 仅限 Windows 用户：安装必要的驱动程序。更完整的说明可以在 Zadig 用户指南中找到。
   1. 如果没有出现相关内容，请尝试卸载任何与三星相关的 Windows 软件，例如 Samsung Windows 驱动程序和/或 Samsung Kies。
   2. 运行在您解压的 Heimdall 目录中找到的 zadig.exe。
      info_outline

      注意：对于感兴趣的用户，可以在此处找到 zadig.exe 的源代码和文档。
   3. 从菜单中选择 Options（选项） » List all devices（列出所有设备）。
   4. 从下拉菜单中选择 USB ID 为 04E8 685D 的设备。
   5. 点击 Replace Driver（替换驱动程序），然后从按钮内置的下拉列表中选择 Install Driver（安装驱动程序）。
   6. 如果您收到警告，提示安装程序无法验证驱动程序的发布者，请选择 Install this driver anyway（仍然安装此驱动程序）。您可能会收到另外两个关于安全性的提示。选择接受警告并允许您继续的选项。
5. 在您的计算机上，打开命令提示符或 PowerShell (Windows) 窗口，或终端 (Linux 或 macOS) 窗口，并输入

   heimdall print-pit
   

6. 如果设备重启，则表明 Heimdall 已安装并正常工作。如果设备没有重启，请重新按照这些说明操作，以验证是否遗漏了步骤，尝试使用不同的 USB 数据线和不同的 USB 端口。

使用 heimdall 安装 Lineage Recovery

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

   重要提示：其他 recovery 可能无法用于安装或更新。我们强烈建议使用上面链接的 recovery！
2. 关闭设备电源，并将其启动到下载模式。
   • 在设备关机状态下，按住 音量减小 + Bixby + 电源 键。
   • 现在，点击屏幕上指示对应 “Continue（继续）” 的按钮，并将 USB 数据线插入设备。
3. 在您的计算机上，打开命令提示符或 PowerShell (Windows) 窗口，或终端 (Linux 或 macOS) 窗口，并输入

   heimdall flash --RECOVERY recovery.img --no-reboot
   

   check

   提示：文件名可能与此命令中显示的名称不完全相同，因此请进行相应调整。如果文件被压缩在 zip 或 tar 文件中，请先解压文件，因为 Heimdall 不会为您执行此操作。
4. 设备上将出现一个传输条，显示正在刷入 recovery 镜像。
   info_outline

   注意：即使过程完成，设备仍将继续显示 Downloading... Do not turn off target!!。
5. 手动重启进入 recovery，这可能需要取出设备的电池并重新装入，或者如果您使用的是不可拆卸电池，请按住音量减小 + 电源按钮 8~10 秒，直到屏幕变黑，并在屏幕变黑时立即松开按钮，然后启动到 recovery。
   • 在设备关机状态下，按住 音量增大 + Bixby + 电源 键。当出现蓝色文字时，松开按钮。
   info_outline

   注意：请务必在安装自定义 recovery 后立即重启进入 recovery。如果您不这样做，原厂 ROM 将使用原厂 recovery 覆盖自定义 recovery，您需要再次刷入。
   info_outline

   注意：如果您的 recovery 没有显示 LineageOS 徽标，则说明您意外启动到了错误的 recovery。请从本节顶部重新开始！

从 recovery 安装 LineageOS

1. 构建 LineageOS 安装包。
2. 如果您不在 recovery 中，请重启进入 recovery
   • 在设备关机状态下，按住 音量增大 + Bixby + 电源 键。当出现蓝色文字时，松开按钮。
3. 现在点击 Factory Reset（恢复出厂设置），然后点击 Format data / factory reset（格式化数据/恢复出厂设置） 并继续格式化过程。这将移除加密并删除存储在内部存储中的所有文件，并格式化您的缓存分区（如果有）。
4. 返回主菜单。
5. Sideload LineageOS .zip 包，但在您阅读/遵循其余说明之前，请勿重启！
   • 在设备上，选择 “Apply Update（应用更新）”，然后选择 “Apply from ADB（从 ADB 应用）” 以开始 sideload。
   • 在主机上，使用以下命令 sideload 包：adb -d sideload filename.zip。
     check

     提示：通常，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，请参阅我们的常见问题解答。
• 如果您的设备在每次启动时都显示警告 - 除了忽略它，您无能为力。
• 请不要使用任何方法卸载系统应用。我们已经只发布了最少的应用集，这样做可能会破坏您的系统。我们已警告您！
• 我们不支持任何 root 方法，因此不会在我们的任何平台上提供相关支持。
• LineageOS 是 Android 系统。它像任何其他 Android 设备一样支持应用，但应用可能会选择阻止您使用它们。请返回您设备的“已知问题”部分并阅读关于 “设备完整性” 的内容。