刷写设备

本页详细介绍了如何在特定设备上运行 build。这些详细信息是对构建 Android 部分的补充。

构建 fastboot 和 adb

如果您还没有 fastboot 和 adb，可以使用常规构建系统进行构建。请按照构建 Android 中的说明操作，并将主 make 命令替换为以下命令：

make fastboot adb

如需详细了解 Android 调试桥 (ADB)，请参阅 Android 调试桥 (ADB)。

启动进入 fastboot 模式

您可以在设备处于 fastboot 引导加载程序模式时刷写设备。如需在设备进行冷启动时进入 fastboot 模式，请使用下表中指定的组合键。

您也可以使用 adb reboot bootloader 命令直接重新启动进入引导加载程序。如需查看完整说明，请参阅刷写说明。

设备 代号 组合键
Pixel 6 Pro raven 按住音量调低键，然后按住电源键。
Pixel 6 oriole 按住音量调低键，然后按住电源键。
Pixel 5a (5G) barbet 按住音量调低键，然后按住电源键。
Pixel 5 redfin 按住音量调低按钮，然后按住电源键。
Pixel 4a (5G) bramble 按住音量调低按钮，然后按住电源键。
Pixel 4a sunfish 按住音量调低按钮，然后按住电源键。
Pixel 4 XL coral 按住音量调低按钮，然后按住电源键。
Pixel 4 flame 按住音量调低按钮，然后按住电源键。
Pixel 3a XL bonito 按住音量调低键，然后按住电源键。
Pixel 3a sargo 按住音量调低键，然后按住电源键。
Pixel 3 XL crosshatch 按住音量调低键，然后按住电源键。
Pixel 3 blueline 按住音量调低键，然后按住电源键。
Pixel 2 XL taimen 按住音量调低键，然后按住电源键。
Pixel 2 walleye 按住音量调低键，然后按住电源键。
Pixel XL marlin 按住音量调低键，然后按住电源键。
Pixel sailfish 按住音量调低键，然后按住电源键。
hikey hikey 连接 J15 的引脚 1-2 和 5-6。
Nexus 6P angler 按住音量调低键，然后按住电源键。
Nexus 5X bullhead 按住音量调低键，然后按住电源键。
Nexus 6 shamu 按住音量调低键，然后按住电源键。
Nexus Player fugu 按住电源键。
Nexus 9 volantis 按住音量调低键，然后按住电源键。
Nexus 5 hammerhead 同时按住音量调高键和音量调低键，然后按住电源键。
Nexus 7 flo 按住音量调低键，然后按住电源键。
Nexus 7 3G deb 按住音量调低键，然后按住电源键。
Nexus 10 manta 同时按住音量调高键和音量调低键，然后按住电源键。
Nexus 4 mako 按住音量调低键，然后按住电源键。
Nexus 7 (2012) grouper 按住音量调低键，然后按住电源键。
Nexus 7 3G (2012) tilapia 按住音量调低键，然后按住电源键。
Nexus Q phantasm 启动设备，然后在 LED 指示灯亮起后用一只手盖住设备，直至指示灯变成红色。
Galaxy Nexus GSM maguro 同时按住音量调高键和音量调低键，然后按住电源键。
Galaxy Nexus (Verizon) toro 同时按住音量调高键和音量调低键，然后按住电源键。
Galaxy Nexus (Sprint) toroplus 同时按住音量调高键和音量调低键，然后按住电源键。
Motorola Xoom wingray 按住音量调低键，然后按住电源键。
Nexus S crespo 按住音量调高键，然后按住电源键。
Nexus SG crespo4g 按住音量调高键，然后按住电源键。

解锁引导加载程序

只有在引导加载程序允许的情况下，您才可以刷写自定义系统。但请注意，引导加载程序默认处于锁定状态。您可以解锁引导加载程序，但这样做会导致系统出于隐私原因而删除用户数据。解锁之后，系统会清空设备上的所有数据，即应用中的私人数据以及可通过 USB 访问的共享数据（包括照片和影片）。请先备份设备上的所有重要文件，然后再尝试解锁引导加载程序。

您只需解锁引导加载程序一次，并可视需要将其重新锁定。

解锁新款设备

自 2014 年以来发布的所有 Nexus 和 Pixel 设备（从 Nexus 6 和 Nexus 9 开始）都内置有恢复出厂设置保护功能，需要执行多个步骤才能解锁引导加载程序。

  1. 如需在设备上启用 OEM 解锁功能，请执行以下操作：
    1. 在“设置”中，点按关于手机，然后点按版本号七次。
    2. 当看到“您现在处于开发者模式！”这条消息后，点按返回按钮。
    3. 在“设置”中，依次点按系统和开发者选项，然后启用 OEM 解锁和 USB 调试。（如果 OEM 解锁处于停用状态，请连接到互联网，以便设备可以至少登记一次。如果“OEM 解锁”仍处于停用状态，说明设备可能已被运营商锁定 SIM 卡，系统无法解锁引导加载程序。）
  2. 重新启动进入引导加载程序，然后使用 fastboot 解锁。
    • 对于新款设备（2015 年及之后发布的设备）：
      fastboot flashing unlock
    • 对于老款设备（2014 年及之前发布的设备）：
      fastboot oem unlock
    提示：如果您在重新启动前看到“adb devices”输出，但 fastboot 或刷写脚本运行异常，则可能是您的 USB 线有问题。请尝试使用其他端口和/或切换连接器。如果您在计算机上使用 USB C 端口，请尝试改用 USB A 端口。
  3. 在屏幕上确认解锁。

重新锁定引导加载程序

如需重新锁定引导加载程序，请执行以下命令：

  • 对于新款设备（2015 年及之后发布的设备）：
    fastboot flashing lock
  • 对于老款设备（2014 年及之前发布的设备）：
    fastboot oem lock

使用刷写锁定状态

getFlashLockState() 系统 API 会传输引导加载程序状态，PersistentDataBlockManager.getFlashLockState() 系统 API 会返回兼容设备上引导加载程序的锁定状态。

返回值 条件
FLASH_LOCK_UNKNOWN 仅升级到 Android 7.x 或更高版本且符合以下条件的设备会返回此值：设备支持刷写锁定/解锁功能，但之前不支持获取刷写锁定状态所需的引导加载程序变更。
  • 运行 Android 7.x 或更高版本的新设备必须处于 FLASH_LOCK_LOCKED 或 FLASH_LOCK_UNLOCKED 状态。
  • 升级到 Android 7.x 或更高版本且不支持刷写解锁/锁定功能的设备应返回 FLASH_LOCK_LOCKED 状态。
FLASH_LOCK_LOCKED 不支持刷写锁定/解锁的所有设备（即设备始终处于锁定状态）或支持刷写锁定/解锁且处于锁定状态的所有设备会返回此值。
FLASH_LOCK_UNLOCKED 支持刷写锁定/解锁且处于解锁状态的所有设备会返回此值。

制造商应测试由已锁定/解锁引导加载程序的设备返回的值。举例来说，Android 开源项目 (AOSP) 包含一个参考实现，该实现返回基于 ro.boot.flash.locked 引导属性的值。示例代码位于以下目录中：

  • frameworks/base/services/core/java/com/android/server/PersistentDataBlockService.java
  • frameworks/base/core/java/android/service/persistentdata/PersistentDataBlockManager.java

选择设备 build

lunch 菜单中提供了建议的设备 build，在不使用任何参数的情况下运行 lunch 命令即可查看。如需可用构建类型的信息及有关 lunch 命令的更多信息，请参阅选择目标。

您可以从 developers.google.com 下载 Pixel 和 Nexus 设备的出厂映像和二进制文件。有关下载内容，请参阅设备二进制文件。有关详情以及其他资源，请参阅获取专有二进制文件。

设备 代号 build 配置
Pixel 6 Pro raven aosp_raven-userdebug
Pixel 6 oriole aosp_oriole-userdebug
Pixel 5 redfin aosp_redfin-userdebug
Pixel 4a 5G bramble aosp_bramble-userdebug
Pixel 4a sunfish aosp_sunfish-userdebug
Pixel 4 XL coral aosp_coral-userdebug
Pixel 4 flame aosp_flame-userdebug
Pixel 3a XL bonito aosp_bonito-userdebug
Pixel 3a sargo aosp_sargo-userdebug
Pixel 3 XL crosshatch aosp_crosshatch-userdebug
Pixel 3 blueline aosp_blueline-userdebug
Pixel 2 XL taimen aosp_taimen-userdebug
Pixel 2 walleye aosp_walleye-userdebug
Pixel XL marlin aosp_marlin-userdebug
Pixel sailfish aosp_sailfish-userdebug
HiKey hikey hikey-userdebug
Nexus 6P angler aosp_angler-userdebug
Nexus 5X bullhead aosp_bullhead-userdebug
Nexus 6 shamu aosp_shamu-userdebug
Nexus Player fugu aosp_fugu-userdebug
Nexus 9 volantis (flounder) aosp_flounder-userdebug
Nexus 5 (GSM/LTE) hammerhead aosp_hammerhead-userdebug
Nexus 7 (WLAN) razor (flo) aosp_flo-userdebug
Nexus 7（移动版） razorg (deb) aosp_deb-userdebug
Nexus 10 mantaray (manta) full_manta-userdebug
Nexus 4 occam (mako) full_mako-userdebug
Nexus 7 (WLAN) nakasi (grouper) full_grouper-userdebug
Nexus 7（移动版） nakasig (tilapia) full_tilapia-userdebug
Galaxy Nexus (GSM/HSPA+) yakju (maguro) full_maguro-userdebug
Galaxy Nexus (Verizon) mysid (toro) √aosp_toro-userdebug
Galaxy Nexus（实验版） mysidspr (toroplus) aosp_toroplus-userdebug
Motorola Xoom（美国 WLAN 版） wingray full_wingray-userdebug
Nexus S soju (crespo) full_crespo-userdebug
Nexus S 4G sojus (crespo4g) full_crespo4g-userdebug

刷写设备

您可以通过运行一个命令来刷写整个 Android 系统；这样做可验证并确保正在被刷写的系统与已安装的引导加载程序和无线驱动程序兼容，还可以将启动、恢复和系统分区一起写入，然后重新启动系统。与 fastboot oem unlock 类似，刷写设备也会清空所有用户数据。

如需刷写设备，请执行以下操作：

  1. 在启动时按住相应的组合键或使用以下命令使设备进入 fastboot 模式：
    adb reboot bootloader
  2. 在设备处于 fastboot 模式后，运行以下命令：
    fastboot flashall -w
     -w 选项会擦除设备上的 /data 分区；该选项在您第一次刷写特定设备时非常有用，但在其他情况下则没必要使用。

使设备恢复到出厂状态

您可以在 Nexus 和 Pixel 设备的出厂映像上查看 Google 设备的出厂映像。Motorola Xoom 的出厂映像由 Motorola 直接分发。