Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.
Stay organized with collections
Save and categorize content based on your preferences.
To test your build, you can either run your build on an emulator or run (flash)
it on an actual device.
Test your build on an emulator
Cuttlefish is a virtual device emulator used to test your builds. For
information on running a build on Cuttlefish, see
Get started
guide.
For app testing, including Google Automotive Services (GAS) apps, use
Android Emulator.
Test your build on a device
The fastboot tool lets you to flash more device types than the Android
Flash Tool and can be use to flash your own local builds to devices for testing.
For information on using the fastboot command-line tool, see
Flash with Fastboot
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-08-29 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[],[],null,["# Test a build\n\nTo test your build, you can either run your build on an emulator or run (flash)\nit on an actual device.\n| **Note:** If you intend to test your build on a device, remember to obtain the proprietary binaries or your build won't boot successfully. Sometimes the source might have different binaries for different builds and branches. If you obtain binary blobs at this point, you need to unpack them, `m installclean`, and rebuild. For more information on this process, see [Download proprietary binaries](/docs/setup/download#downloading-proprietary-binaries).\n\nTest your build on an emulator\n------------------------------\n\n*Cuttlefish* is a virtual device emulator used to test your builds. For\ninformation on running a build on Cuttlefish, see\n[Get started](/docs/devices/cuttlefish/get-started)\nguide.\n\nFor app testing, including Google Automotive Services (GAS) apps, use\n[Android Emulator](/docs/automotive/start/what_automotive#google-automotive-services-gas).\n\nTest your build on a device\n---------------------------\n\nThe *fastboot* tool lets you to flash more device types than the Android\nFlash Tool and can be use to flash your own local builds to devices for testing.\n\nFor information on using the fastboot command-line tool, see\n[Flash with Fastboot](/docs/setup/test/running)\n| **Note:** Google provides an additional flash tool, called [*Android Flash Tool*](/docs/setup/test/flash) that is intended for use only with prebuilt builds. Android Flash Tool is easier to use than the fastboot, but supports fewer devices."]]
