android官方文檔：ubuntu10.04下編譯android源碼Building the System

在編譯前請先看

http://blog.csdn.net/wufenglong/archive/2011/05/11/6411688.aspx

初始化編譯環境 Initializing aBuild Environment 

 

 

Buildingthe System

Thebasic sequence of build commands is as follows:

Initialize

Initializethe environment with the envsetup.sh script.Note that replacing "source" with a single dot saves a fewcharacters, and the short form is more commonly used indocumentation.

$ source build/envsetup.sh

or

$ . build/envsetup.sh

Choosea Target

Choosewhich target to build with lunch.The exact configuration can be passed as an argument, e.g.

$ lunch full-eng

Theexample above refers to a complete build for the emulator, with alldebugging enabled.

Ifrun with no arguments lunch willprompt you to choose a target from the menu.

Allbuild targets take the form BUILD-BUILDTYPE, where the BUILD is acodename referring to the particular feature combination:

Buildname	Device	Notes
full	emulator	fullyconfigured with all languages, apps, input methods
full_maguro	maguro	full buildrunning on Galaxy Nexus GSM/HSPA+ ("maguro")
full_panda	panda	full buildrunning on PandaBoard ("panda")

andthe BUILDTYPE is one of the following:

Buildtype	Use
user	limitedaccess; suited for production
userdebug	like"user" but with root access and debuggability;preferred for debugging
eng	developmentconfiguration with additional debugging tools

Formore information about building for and running on actual hardware,see Buildingfor devices

Buildthe Code

Buildeverything with make.GNU make can handle parallel tasks with a -jN argument,and it's common to use a number of tasks N that's between 1 and 2times the number of hardware threads on the computer being used forthe build. E.g. on a dual-E5520 machine (2 CPUs, 4 cores per CPU, 2threads per core), the fastest builds are made with commandsbetween make-j16 and make-j32.

$ make -j4

RunIt!

Youcan either run your build on an emulator or flash it on a device.Please note that you have already selected your build targetwith lunch,and it is unlikely at best to run on a different target than it wasbuilt for.

Flasha Device

Toflash a device, you will need to use fastboot,which should be included in your path after a successful build. Placethe device in fastboot mode either manually by holding theappropriate key combination at boot, or from the shell with

$ adb reboot bootloader

Oncethe device is in fastboot mode, run

$ fastboot flashall -w

The -w optionwipes the /data partitionon the device; this is useful for your first time flashing aparticular device, but is otherwise unnecessary.

Formore information about building for and running on actual hardware,see Buildingfor devices

Emulatean Android Device

Theemulator is added to your path automatically by the build process. Torun the emulator, type

$ emulator

Usingccache

ccacheis a compiler cache for C and C++ that can help make builds faster.In the root of the source tree, do the following:

$ export USE_CCACHE=1
$ export CCACHE_DIR=/<path_of_your_choice>/.ccache
$ prebuilt/linux-x86/ccache/ccache -M 20G

Youcan watch ccache being used by doing the following:

$ watch -n1 -d prebuilt/linux-x86/ccache/ccache -s

OnOSX, you should replace linux-x86 with darwin-x86.

TroubleshootingCommon Build Errors

WrongJava Version

Ifyou are attempting to build froyo or earlier with Java 1.6, orgingerbread or later with Java 1.5, make willabort with a message such as

************************************************************
You are attempting to build with the incorrect version
of java.

Your version is: WRONG_VERSION.
The correct version is: RIGHT_VERSION.

Please follow the machine setup instructions at
    http://source.android.com/download
************************************************************

Thismay be caused by

• failingto install the correct JDK as specified on the Initializing page.Building Android requires Sun JDK 5 or 6 depending on which releaseyou are building.

• anotherJDK that you previously installed appearing in your path. You canremove the offending JDK from your path with:

  $ export PATH=${PATH/\/path\/to\/jdk\/dir:/}

PythonVersion 3

Repois built on particular functionality from Python 2.x and isunfortunately incompatible with Python 3. In order to use repo,please install Python 2.x:

$ apt-get install python

GmakeVersion 3.82

Thereis a bug in make version3.82 on Mac OS that prevents building Android.

TODO:what the error looks like with GNU make 3.82 on older builds thatdon't explicitly detect it.

Followthe instructions on the Initializing pagefor reverting GNU make from 3.82 to 3.81.

CaseInsensitive Filesystem

Ifyou are building on an HFS filesystem on Mac OS X, you may encounteran error such as

************************************************************
You are building on a case-insensitive filesystem.
Please move your source tree to a case-sensitive filesystem.
************************************************************

Pleasefollow the instructions on the Initializing pagefor creating a case-sensitive disk image.

NoUSB Permission

Onmost Linux systems, unprivileged users cannot access USB ports bydefault. If you see a permission denied error, follow theinstructions on the Initializing pagefor configuring USB access.

Ifadb was already running and cannot connect to the device aftergetting those rules set up, it can be killed with adbkill-server.That will cause adb to restart with the new configuration.