Building For Dream Or Sapphire

今天突然可以访问source.android.com了。。。。赶快把文档复制下来

Building For Dream Or Sapphire

The basic manifest for donut (and above) defines which projects are needed to do a generic build for flashable Dream and Sapphire devices (i.e. respectively the Android Dev Phone 1 and the Google I/O device).

This instructions are ONLY meant to be used with Android Dev Phone 1 and the Google I/O device, as those are the only devices covered by there instructions that are explicitly specified to be flashable with custom builds. Don't forget to delete the files that you downloaded or extracted once you're done using them.

To build donut or master for dream or sapphire:

1. Follow the normal steps to set up repo and check out the sources.
2. Download the recovery image for your device from HTC's developer site, and save it at the root of your source tree.
   
3. If you are using an Android Dev Phone 1, download the archive of ADP1 proprietary binaries from HTC's developer site, save it in vendor/htc/dream-open/, decompress it, and execute it from that directory.
   
4. From the vendor/htc/dream-open/ directory (or vendor/htc/sapphire-open/ if you have a Google I/O device), run the "unzip-files.sh" script to unzip some proprietary files for your device (*). The current files (Oct 19 2009) are called signed-dream_devphone_userdebug-ota-14721.zip and signed-google_ion-ota-14721.zip.
5. At the root of your source tree, run ". build/envsetup.sh" like you normally would for an emulator build.
   
6. run "lunch aosp_dream_us-eng" to specifically configure the build system for dream, or "lunch aosp_sapphire_us-eng" for sapphire. Other configurations might also exist.
   
7. run "make -j4" and have a cup of coffee (or a nap, depending on how fast your machine is). Use different values for the -j parameter as appropriate.
   
8. from this point, the fastboot tool (which is put automatically in your path) can be used to flash a device: boot the device into the bootloader by holding the back key while pressing the power key, and run "fastboot -w flashall".
   

To build cupcake for dream (your device needs to be an ADP1 running an official 1.5 system):

1. Follow the normal steps to set up repo and check out the sources.
2. At the root of your source tree, run ". build/envsetup.sh" like you normally would for an emulator build.
3. Run "make adb" if you don't already have adb in your path.
   
4. in vendor/htc/dream-open/ there is a script called "extract-files.sh" that must be run (from that directory) to extract some proprietary binaries from your device (*). You only need to do this once.
   
5. run "lunch htc_dream-eng" to specifically configure the build system for dream (the default is the equivalent of "lunch generic-eng", which doesn't contain dream-specific files).
   
6. run make from the top of the source tree.
7. from this point, the fastboot tool (which is put automatically in your path) can be used to flash a device: boot the device into the bootloader by holding the back key while pressing the power key, and run "fastboot -w flashall".
   

* The Dream and Sapphire device software contains some proprietary files.  For contractual reasons, those cannot be redistributed to be used directly with the Android Open-Source Project, but the provided script may be used to extract these binaries from your development device or from a recovery image so that they can be correctly included in your build. Those libraries include the openGL|ES library, the Qualcomm camera library, the HTC Radio Interface Library, etc.