2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
개발 플랫폼으로서의 Pixel 기기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드는 주로 AAOS를 사용하여 테스트하고 개발하려는 개발자를 대상으로 합니다.
주의사항
다음과 같은 제한사항이 Pixel을 개발 플랫폼으로 사용할 때 적용됩니다.
기본 요건
계속하기 전에 다음 항목이 있는지 확인하세요.
- 필수 항목인 OEM 잠금 해제.
- Android 코드를 빌드할 수 있는 Linux 데스크톱. 자세한 내용은 빌드 환경 설정을 참고하세요.
코드 동기화 및 빌드
- Android 빌드 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에서 AP1A.240405.002용 Pixel 기기의 공급업체 이미지를 다운로드합니다.
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/envsetup.sh
lunch aosp_tangorpro_car-ap1a-userdebug
m
- Automotive 관련 패키지를 빌드합니다.
m android.hardware.automotive.vehicle@2.0-default-service android.hardware.automotive.audiocontrol-service.example
빌드를 플래시하도록 기기 설정
아직 개발자 옵션을 사용 설정하지 않은 경우 사용 설정하세요. 설정 > 시스템 > 휴대전화 정보로 이동한 다음 빌드 번호를 7번 탭합니다.
개발자 옵션을 사용 설정한 경우:
- 설정 > 시스템 > 개발자 옵션으로 이동하여 USB 디버깅과 OEM 잠금 해제를 사용 설정합니다.
빌드 플래시
- 기기를 빠른 부팅 모드로 전환한 다음 잠금 해제합니다.
adb reboot bootloader
fastboot flashing unlock
- 기기에서 부트로더 로드 취소를 선택합니다. 이렇게 하면 기기의 모든 데이터가 삭제됩니다.
- 빌드를 플래시하려면 다음을 실행합니다.
fastboot -w flashall
- 빌드가 애니메이션으로 부팅을 시작하면 다음을 실행합니다.
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
- 필수 Automotive 관련 파일을 기기에 푸시하려면 다음을 실행합니다.
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"
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","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"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],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 ```"]]
