在以下设备安装 LineageOS
Samsung Galaxy A5 (2017)

基本要求

1. 在实际操作之前，请至少完整阅读一遍说明，以避免因遗漏步骤而产生任何问题！
2. 确保您的计算机已安装 adb。 设置说明可以在这里找到。
3. 在您的设备上启用 USB 调试。
4. 确保您的型号是以下型号之一（需要完全匹配！）：
   • SM-A520F
   • SM-A520F/DS
   • SM-A520K
   • SM-A520L
   • SM-A520S
   • SM-A520W
5. 使用原厂操作系统至少启动设备一次，并检查所有功能。
6. 从您的设备中移除所有 Google 帐户，以避免“恢复出厂设置保护”。
7. LineageOS 按原样提供，不提供任何担保。 尽管我们尝试验证 所有功能都正常工作，但您仍需自行承担安装风险！

检查正确的固件

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

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

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

准备安装

Samsung 设备配备一种独特的启动模式，称为“下载模式”，它与某些已解锁引导加载程序的设备上的“Fastboot 模式”非常相似。 Heimdall 是一个跨平台的开源工具，用于与 Samsung 设备上的下载模式进行交互。 安装自定义 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. 关闭设备电源，并将其启动到下载模式。
   • 在设备关机状态下，按住 Volume Down + Home + Power 键。
   • 现在，点击屏幕指示中对应的“继续”按钮，并将 USB 数据线插入设备。
4. 仅限 Windows 用户：安装必要的驱动程序。 更完整的说明可以在 Zadig 用户指南 中找到。
   1. 如果没有出现相关内容，请尝试卸载任何与 Samsung 相关的 Windows 软件，例如 Samsung Windows 驱动程序和/或 Samsung Kies。
   2. 运行在您解压的 Heimdall 目录中找到的 zadig.exe。
      info_outline

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

   heimdall print-pit
   

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

使用 heimdall 安装 Lineage Recovery

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

   重要提示： 其他 recovery 可能无法用于安装或更新。 我们强烈建议使用上面链接的 recovery！
2. 关闭设备电源，并将其启动到下载模式。
   • 在设备关机状态下，按住 Volume Down + Home + Power 键。
   • 现在，点击屏幕指示中对应的“继续”按钮，并将 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 模式。
   • 在设备关机状态下，按住 Volume Up + Home + Power 键。
   info_outline

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

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

从 recovery 模式安装 LineageOS

1. 构建 LineageOS 安装包。
2. 如果您不在 recovery 模式，请重启进入 recovery 模式
   • 在设备关机状态下，按住 Volume Up + Home + Power 键。
3. 现在点击 恢复出厂设置，然后点击 格式化 data 分区 / 恢复出厂设置 并继续格式化过程。 这将移除加密并删除内部存储中存储的所有文件，以及格式化您的缓存分区（如果有）。
4. 返回主菜单。
5. Sideload LineageOS .zip 包，但在您阅读/遵循其余说明之前 不要重启！
   • 在设备上，选择“应用更新”，然后选择“从 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 的官方密钥签名！

一切就绪！

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

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

如果您想知道下一步该做什么，请继续，否则，请享受您的全新 LineageOS 安装。

接下来做什么？

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