自 2025 年 3 月 27 日起,我们建议您使用 android-latest-release
而非 aosp-main
构建 AOSP 并为其做出贡献。如需了解详情,请参阅 AOSP 的变更。
将 Pixel 设备用作开发平台
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本指南主要面向想使用 AAOS 进行测试和开发的开发者
注意事项
使用 Pixel 作为开发平台时,存在以下限制:
您可能会导致设备变砖,请谨慎使用!
前提条件
继续之前,请确认您满足以下各项:
- 需要 OEM 解锁。
- 能够构建 Android 代码的 Linux 桌面设备。如需了解详情,请参阅搭建构建环境。
代码同步及 build
- 如需同步 Android build AP1A.240405.002,请执行以下操作:
mkdir aaos_on_pixel
cd aaos_on_pixel
REPO_ALLOW_SHALLOW=0 repo init -c -u https://android.googlesource.com/platform/manifest -b android-14.0.0_r30 --use-superproject --partial-clone --partial-clone-exclude=platform/frameworks/base --clone-filter=blob:limit=10M
repo sync -j32
- 从 developers.google.com 下载适用于 Pixel 设备的 AP1A.240405.002 供应商映像
curl --output - https://dl.google.com/dl/android/aosp/google_devices-tangorpro-ap1a.240405.002-8d141153.tgz | tar -xzvf -
tail -n +315 extract-google_devices-tangorpro.sh | tar -zxvf -
- 采用补丁
cd packages/services/Car
git fetch https://android.googlesource.com/platform/packages/services/Car refs/changes/83/3037383/2 && git cherry-pick FETCH_HEAD #fix the audio crash
cd -
- 运行相应 build。:
. build/envsetup.sh
lunch aosp_tangorpro_car-ap1a-userdebug
m
- 构建与汽车相关的软件包:
m android.hardware.automotive.vehicle@2.0-default-service android.hardware.automotive.audiocontrol-service.example
设置设备以刷写 build
如果您尚未执行此操作,请启用开发者选项。依次转到“设置”>“系统”>“关于手机”,然后点按“build 号”七次。
启用“开发者选项”后:
- 依次转到“设置”>“系统”>“开发者选项”,然后启用 USB 调试和 OEM 解锁:
刷写 build
- 将设备置于 Fastboot 模式,然后解锁:
adb reboot bootloader
fastboot flashing unlock
- 在设备上,选择“解锁引导加载程序”。这样做会清空设备上的所有数据!
- 刷写 build:
fastboot -w flashall
- 在 build 开始启动并显示动画后:
- 启用
adb remount
:
#Temporary disable the userdata checkpoint
adb wait-for-device root; sleep 3; adb shell vdc checkpoint commitChanges; sleep 2
#Enable remount
adb remount && sleep 2 && adb reboot && echo "rebooting the device" && adb wait-for-device root && sleep 5 && adb remount
- 将所需的汽车专用文件推送到设备:
adb sync vendor && adb reboot
- 等待设备启动:

提示
- 如果您发现屏幕亮度过低:
adb shell settings put system screen_brightness 255
- 在已插好充电器时启动:
adb reboot bootloader
fastboot oem off-mode-charge 1
fastboot reboot
- 启用模拟位置:
adb unroot
adb shell cmd location set-location-enabled true
adb root
adb shell appops set 0 android:mock_location allow
adb shell cmd location providers add-test-provider gps
adb shell cmd location providers set-test-provider-enabled gps true
adb shell cmd location providers set-test-provider-location gps --location 37.090200,-95.712900
#To verify
adb shell dumpsys location | grep "last location"
如有任何问题,请与 aaos-on-phone@google.com 联系
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-04-04。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-04-04。"],[],[],null,["# Pixel devices as development platforms\n\nThis guide is mainly for developers who want to test and develop using AAOS\n\nCaveats\n-------\n\nThese limitations apply when using a Pixel as development platforms:\n| **Caution:** There is a chance that you can brick your device when using Pixel as a development platform. If a device become bricked, have it repaired by [Google Support.](https://store.google.com/magazine/support)\n\n- The Pixel Tablet is verified and supported. You can visit\n [Google Store](https://store.google.com/product/pixel_tablet) to purchase it.\n\n- The following devices are supported but not actively tested. Be sure to download the correct binaries and then follow the instructions and change the commands as required:\n - Pixel 7, 7a and 7Pro\n - Pixel 8 and 8Pro\n- You *must* use Android 14 , build\n [android-14.0.0_r30](/setup/start/build-numbers#source-code-tags-and-builds).\n\n- Limited support for Bluetooth profiles and some of the profiles will not work at all\n- Tablet does not support GPS, location requires \"mock location app or similar\"\n\nPrerequisites\n-------------\n\nBefore you continue, confirm you have the following items:\n\n1. **OEM unlocking is required.**\n2. **Linux desktop capable of building Android code.** For more information, see [Establishing a Build Environment](/setup/build/initializing).\n\nCode sync and build\n-------------------\n\n1. To sync Android build AP1A.240405.002 : \n\n ```scdoc\n mkdir aaos_on_pixel\n cd aaos_on_pixel\n REPO_ALLOW_SHALLOW=0 repo init -c -u https://android.googlesource.com/platform/manifest -b android-14.0.0_r30 --use-superproject --partial-clone --partial-clone-exclude=platform/frameworks/base --clone-filter=blob:limit=10M \n repo sync -j32\n ```\n2. Download the vendor image for pixel devices from [developers.google.com](https://developers.google.com/android/drivers) for AP1A.240405.002 \n\n ```scdoc\n curl --output - https://dl.google.com/dl/android/aosp/google_devices-tangorpro-ap1a.240405.002-8d141153.tgz | tar -xzvf -\n tail -n +315 extract-google_devices-tangorpro.sh | tar -zxvf -\n ```\n3. Take a patch \n\n ```carbon\n cd packages/services/Car\n git fetch https://android.googlesource.com/platform/packages/services/Car refs/changes/83/3037383/2 && git cherry-pick FETCH_HEAD #fix the audio crash\n cd -\n ```\n4. Run the build. : \n\n ```scdoc\n . build/envsetup.sh\n lunch aosp_tangorpro_car-ap1a-userdebug\n m\n ```\n5. Build the Automotive-related packages: \n\n ```objective-c\n m android.hardware.automotive.vehicle@2.0-default-service android.hardware.automotive.audiocontrol-service.example \n ```\n\nSet up the device to flash the build\n------------------------------------\n\nIf you haven't already done so, enable **Developer options**. Go to Settings \\\u003e\nSystem \\\u003e About Phone and then tap Build Number seven times.\n\nWhen you've enabled Developer options:\n\n1. Go to Settings \\\u003e System \\\u003e Developer options and enable **USB debugging** and **OEM unlocking**:\n\n|---|---|\n| | |\n\nFlash the build\n---------------\n\n1. To place the device into fastboot mode and then unlock it: \n\n ```gdscript\n adb reboot bootloader\n fastboot flashing unlock\n ```\n2. On the device, select Unlock the Bootloader. Doing so erases ***all*** data on the device!\n3. To flash the build: \n\n ```text\n fastboot -w flashall\n ```\n4. After the build start booting with animation:\n 1. To enable `adb remount`: \n\n ```text\n #Temporary disable the userdata checkpoint \n adb wait-for-device root; sleep 3; adb shell vdc checkpoint commitChanges; sleep 2 \n #Enable remount\n adb remount && sleep 2 && adb reboot && echo \"rebooting the device\" && adb wait-for-device root && sleep 5 && adb remount\n ```\n 2. To push the required Automotive-specific files to the device: \n\n ```text\n adb sync vendor && adb reboot\n ```\n 3. Wait for the device to start: \n\n Tips\n ----\n\n5. If you see screen brightness too low: \n\n ```scdoc\n adb shell settings put system screen_brightness 255\n ```\n6. Boot when charger is plugged in: \n\n ```gdscript\n adb reboot bootloader \n fastboot oem off-mode-charge 1\n fastboot reboot\n ```\n7. Enable Mock location: \n\n ```scdoc\n adb unroot\n adb shell cmd location set-location-enabled true\n adb root\n adb shell appops set 0 android:mock_location allow\n adb shell cmd location providers add-test-provider gps\n adb shell cmd location providers set-test-provider-enabled gps true\n adb shell cmd location providers set-test-provider-location gps --location 37.090200,-95.712900\n #To verify\n adb shell dumpsys location | grep \"last location\"\n ```"]]