This page complements the main page about Building with information that is specific to individual devices.
With the current release, it is possible to build for Nexus 7, for some variants of Galaxy Nexus, for a variant of the Motorola Xoom, and for all variants of Nexus S and Nexus S 4G. The exact level of functionality for each device depends on the availability of the relevant proprietary hardware-specific binaries.
All variants of Nexus 7 can be used. On Nexus 7, graphics and audio are functional, as well as WiFi and Bluetooth.
The variants of Galaxy Nexus that be used are the GSM/HSPA+ configuration “maguro” (only if it was originally sold with a “yakju” or “takju” operating system) and the VZW CDMA/LTE configuration “toro”. On those devices, graphics and audio are functional, as well as WiFi, Bluetooth, and access to the respective cellular networks. The orientation sensors are functional.
The Motorola Xoom is can be used in the Wi-Fi configuration “wingray” sold in the USA. Graphics and audio are functional as well as WiFi and Bluetooth and the orientation sensors.
All configurations of Nexus S and Nexus S 4G can be used, and on those devices all the peripherals are functional: graphics, audio, Wifi, Bluetooth, cell networks, sensors, camera, hardware codecs, NFC, GPS.
In addition, PandaBoard a.k.a. “panda” can be used in the master branch, but is considered experimental. The specific details to use a PandaBoard with the Android Open-Source Project are in the file device/ti/panda/README in the source tree.
Nexus One a.k.a. “passion” is obsolete, was experimental in gingerbread, and can't be used with newer versions of the Android Open-Source Project.
Android Developer Phones (ADP1 and ADP2, a.k.a. “dream” and “sapphire”) are obsolete, were experimental in froyo, and can't be used with newer versions of the Android Open-Source Project.
If you don't already have those tools, fastboot and adb can be built with the regular build system. Follow the instructions on the page about building, and replace the main make command with
$ make fastboot adb
During a cold boot, the following key combinations can be used to boot into fastboot mode, which is a mode in the bootloader that can be used to flash the devices:
| Device | Keys |
|---|---|
| grouper | Press Power for a second, and press Volume Down when the bootloader logo appears |
| maguro | Press and hold both Volume Up and Volume Down, then press and hold Power |
| toro | Press and hold both Volume Up and Volume Down, then press and hold Power |
| panda | Press and hold Input, then press Power |
| wingray | Press and hold Volume Down, then press and hold Power |
| crespo | Press and hold Volume Up, then press and hold Power |
| crespo4g | Press and hold Volume Up, then press and hold Power |
| passion | Press and hold the trackball, then press Power |
| sapphire | Press and hold Back, then press Power |
| dream | Press and hold Back, then press Power |
Also, the command adb reboot bootloader can be used to reboot from Android directly into the bootloader with no key combinations.
It's only possible to flash a custom system if the bootloader allows it.
This is the default setup on ADP1 and ADP2.
On Nexus One, Nexus S, Nexus S 4G, Xoom, Galaxy Nexus, and Nexus 7, the bootloader is locked by default. With the device in fastboot mode, the bootloader is unlocked with
$ fastboot oem unlock
The procedure must be confirmed on-screen, and deletes the user data for privacy reasons. It only needs to be run once.
Note that on the Nexus S, Nexus S 4G, Motorola Xoom, Galaxy Nexus, and on Nexus 7, all data on the phone is erased, i.e. both the applications' private data and the shared data that is accessible over USB, including photos and movies. Be sure to make a backup of any precious files you have before unlocking the bootloader.
On Nexus One, the operation voids the warranty and is irreversible.
On Nexus S, Nexus S 4G, Xoom, Galaxy Nexus, and Nexus 7, the bootloader can be locked back with
$ fastboot oem lock
Note that this erases user data on Xoom (including the shared USB data).
Starting with Ice Cream Sandwich, the Android Open-Source Project can't be used from pure source code only, and requires additional hardware-related proprietary libraries to run, specifically for hardware graphics acceleration.
Official binaries for Nexus S, Nexus S 4G, Galaxy Nexus, Nexus 7, and PandaBoard can be downloaded from Google's Nexus driver page, which add access to additional hardware capabilities with non-Open-Source code.
When using the master branch for a device, the binaries for the most recent numbered release are the ones that should be used in the master branch.
There are limited binaries for Nexus One, and none for ADP2 or ADP1.
Each set of binaries comes as a self-extracting script in a compressed archive. After uncompressing each archive, run the included self-extracting script from the root of the source tree, confirm that you agree to the terms of the enclosed license agreement, and the binaries and their matching makefiles will get installed in the vendor/ hierarchy of the source tree.
In order to make sure that the newly installed binaries are properly taken into account after being extracted, the existing output of any previous build needs to be deleted with
$ make clobber
The steps to configure and build the Android Open-Source Project are described in the page about Building.
The recommended builds for the various devices are available through the lunch menu, accessed when running the lunch command with no arguments:
| Device | Branch | Build configuration |
|---|---|---|
| grouper | android-4.1.1_r4 or master | full_grouper-userdebug |
| maguro | android-4.1.1_r4 or master | full_maguro-userdebug |
| toro | android-4.1.1_r4 or master | full_toro-userdebug |
| panda | master | full_panda-userdebug |
| wingray | android-4.1.1_r4 or master | full_wingray-userdebug |
| crespo | android-4.1.1_r4 or master | full_crespo-userdebug |
| crespo4g | android-4.1.1_r4 or master | full_crespo4g-userdebug |
| passion | android-2.3.7_r1 | full_passion-userdebug |
| sapphire | android-2.2.3_r1 | full_sapphire-userdebug |
| dream | android-2.2.3_r1 | full_dream-userdebug |
Set the device in fastboot mode if necessary (see above).
An entire Android system can be flashed in a single command: this writes the boot, recovery and system partitions together after verifying that the system being flashed is compatible with the installed bootloader and radio, and reboots the system. This also erases all the user data, similarly to fastboot oem unlock mentioned earlier.
$ fastboot -w flashall
Note that filesystems created via fastboot on Motorola Xoom aren't working optimally, and it is strongly recommended to re-create them through recovery
$ adb reboot recovery
Once in recovery, open the menu (press Power + Volume Up), wipe the cache partition, then wipe data.
Factory images for Nexus 7, for Galaxy Nexus (GSM/HSPA+ “yakju” and “takju”, and CDMA/LTE “mysid”), and for Nexus S and Nexus S 4G (all variants) are available from Google's factory image page.
Factory images for the Motorola Xoom are distributed directly by Motorola.
No factory images are available for Nexus One.