Android 编译大全

Android编译大全（二）
2.  编译源代码

v  执行ls -la /bin/sh命令，如果输出如下：

rwxrwxrwx 1 root root 4 2010-02-10 17:14 /bin/sh -> dash

请执行$sudo dpkg-reconfigure dash命令修改sh版本，并选择“否”；

此处如果不改好的话，编译时会出现错误。

 

v  执行source build/envsetup.sh命令

v  执行choosecombo命令，出现选择对话框

u  Build for the simulator or the device?

u       1. Device

u       2. Simulator

u  

u  Which would you like? [1]   

u   

u  Build type choices are:

u       1. release

u       2. debug

u  

u  Which would you like? [2]

u  

u  Product choices are:

u       1. core

u       2. full_dream

u       3. full

u       4. full_passion

u       5. full_sapphire

u       6. generic_dream

u       7. generic

u       8. generic_passion

u       9. generic_sapphire

u       10. msm7625_qrd

u       11. msm7627_ffa

u       12. msm7627_surf

u       13. msm7630_surf

u       14. qsd8250_ffa

u       15. qsd8250_surf

u       16. sample_addon

u       17. sdk

u       18. sim

u  You can also type the name of a product if you know it.

u  Which product would you like? [generic] 3

u  

u  Variant choices are:

u       1. user

u       2. userdebug

u       3. eng

u  Which would you like? [eng]

 

如果执行这个命令的时候，报错：/bin/sh: Syntax error: "(" unexpected

#请执行$sudo dpkg-reconfigure dash命令，并选择“否”；

 

v  配置环境变量

export JAVA_HOME=/usr/lib/jvm/java-5-sun

export CLASSPATH=$JAVA_HOME/lib

export JRE_HOME=$JAVA_HOME/jre

export JAVA_PATH=$JAVA_HOME/bin:$JRE_HOME/bin

export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib:

$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

export ANDROID_JAVA_HOME=$JAVA_HOME

export PATH=$JAVA_PATH:$PATH

 

v  执行make命令

如果安装的是java1.6，将报错，如下：

Your version is: java version "1.6.0_15".

The correct version is: 1.5.

 

解决java编译错误，如下：

1)     下载jdk1.5（ftp://202.112.80.252/java/jdk-1_5_0_21-linux-i586.bin）；

2)     将jdk-1_5_0_21-linux-i586.bin变为可执行权限

$sudo chmod a+x jdk-1_5_0_21-linux-i586.bin

3)     在命令行下执行./jdk-1_5_0_21-linux-i586.bin安装sdk

4)     建立一个软连接到jdk目录

$sudo ln jdk1.5.0_21/ java-5-sun -s

5)     然后配置环境变量：sudo gedit/etc/enviroment在其中添加两行：

CLASSPATH=/usr/lib/jvm/java-5-sun/lib

JAVA_HOME=/usr/lib/jvm/java-5-sun

 

如果在出现类似使用了旧版api的错误，请先按照提示执行make update-api命令。该命令执行结束之后，再继续执行make命令就可以编译成功了。

 

在配置好shell命令类型之后，也可以新建一个shell脚本如下，进行自动编译：

export JAVA_HOME=/usr/lib/jvm/java-5-sun

export CLASSPATH=$JAVA_HOME/lib

export JRE_HOME=$JAVA_HOME/jre

export JAVA_PATH=$JAVA_HOME/bin:$JRE_HOME/bin

export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

export ANDROID_JAVA_HOME=$JAVA_HOME

export PATH=$JAVA_PATH:$PATH

source build/envsetup.sh

choosecombo 1 1 7 3

make

 

 build之后的log如下：

… …

creating boot.img...

creating recovery.img...

creating system.img...

creating userdata.img...

cleaning up...

Done.
Android编译大全（三）
3.  验证编译之后的模块

$export ANDROID_PRODUCT_OUT=/out/target/product/generic

$cd ./out/host/linux-x86/bin

$./emulator

 

 
4.  编译完成之后的代码结构

Android编译完成后，将在根目录中生成一个out文件夹，所有生成的内容均放置在这个文件夹中。out文件夹如下所示：
　　out/
　　|-- CaseCheck.txt
　　|-- casecheck.txt
　　|-- host
　　|   |-- common
　　|   `-- linux-x86
　　`-- target
　　    |-- common
　　    `-- product

    主要的两个目录为host和target，前者表示在主机（x86）生成的工具，后者表示目标机（模认为ARMv5）运行的内容。

host目录的结构如下所示：
　　out/host/
　　|-- common
　　|   `-- obj              （JAVA库）
　　`-- linux-x86
　　    |-- bin              （二进制程序）
　　    |-- framework        （JAVA库,＊.jar文件）
　　    |-- lib              （共享库*.so）
　　    `-- obj              （中间生成的目标文件）
　　host目录是一些在主机上用的工具，有一些是二进制程序,有一些是JAVA的程序。

　　target目录的结构如下所示：
　　out/target/
　　|-- common
　　|   |-- R           （资源文件）
　　|   |-- docs
　　|   `-- obj         （目标文件）
　　`-- product
　　    `-- generic
　　其中common目录表示通用的内容，product中则是针对产品的内容。
　　在common目录的obj中，包含两个重要的目录：
　　APPS  中包含了JAVA应用程序生成的目标，每个应用程序对应其中一个子目录，将结合每个应用程序的原始文件生成Android应用程序的APK包。
　　JAVA_LIBRARIES  中包含了JAVA的库，每个库对应其中一个子目录。

　　在默认的情况下，Android编译将生成generic目录，如果选定产品还可以生成其他的目录。generic包含了以下内容：
　　out/target/product/generic/
　　|-- android-info.txt
　　|-- clean_steps.mk
　　|-- data
　　|-- obj
　　|-- ramdisk.img
　　|-- root
　　|-- symbols
　　|-- system
　　|-- system.img
　　|-- userdata-qemu.img
　　`-- userdata.img

　　在generic/obj/APPS目录中包含了各种JAVA应用，与common/APPS相对应，但是已经打成了APK包。
　　system目录是主要的文件系统，data目录是存放数据的文件系统。
　　obj/SHARED_LIBRARIES中存放所有动态库。
　　obj/STATIC_LIBRARIES中存放所有静态库。
　　几个以img为结尾的文件是几个目标映像文件，其中ramdisk是作为内存盘的根文件系统映像，system.img是主要文件系统的映像，这是一个比较大的文件，data.img是数据内容映像。这几个image文件是运行时真正需要的文件。
5.  make SDK
5.1. sdk编译

在编译完整个系统之后，再运行make sdk，就可以进行sdk的编译了。make sdk将各种工具和image打包，供开发和调试使用。

export JAVA_HOME=/usr/lib/jvm/java-5-sun

export CLASSPATH=$JAVA_HOME/lib

export JRE_HOME=$JAVA_HOME/jre

export JAVA_PATH=$JAVA_HOME/bin:$JRE_HOME/bin

export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

export ANDROID_JAVA_HOME=$JAVA_HOME

export PATH=$JAVA_PATH:$PATH

 

source build/envsetup.sh

make sdk

 

 

 

……

Package SDK Stubs: out/target/common/obj/PACKAGING/android_jar_intermediates/android.jar

Package SDK: out/host/linux-x86/sdk/android-sdk_eng.huangjx_linux-x86.zip

build之后的log如下：

 
5.2. 验证编译之后的模块

将out/host/linux-x86/sdk/android-sdk_eng.huangjx_linux-x86.zip解压到本地目录。进入tools目录，输入下面的命令创建AVD：

$./android create avd -t 1 -c 128M -n froyo -s HVGA

Android 2.2 is a basic Android platform.

Do you wish to create a custom hardware profile [no]

Created AVD 'froyo' based on Android 2.2, with the following hardware config:

hw.lcd.density=160

输入下面的命令，启动模拟器：

$ ./emulator -avd froyo -partition-size 160 &
Android编译大全（四）
6.  编译详细分解
6.1. build系统简介
6.1.1.build系统文件结构

./build

|-- CleanSpec.mk

|-- buildspec.mk.default

|-- core

|   |-- Makefile

|   |-- apicheck_msg_current.txt

|   |-- apicheck_msg_last.txt

|   |-- armelf.x

|   |-- armelf.xsc

|   |-- armelflib.x

|   |-- base_rules.mk

|   |-- binary.mk

|   |-- build-system.html

|   |-- build_id.mk

|   |-- checktree

|   |-- cleanbuild.mk

|   |-- cleanspec.mk

|   |-- clear_vars.mk

|   |-- combo

|   |   |-- HOST_darwin-x86.mk

|   |   |-- HOST_linux-x86.mk

|   |   |-- HOST_windows-x86.mk

|   |   |-- TARGET_linux-arm.mk

|   |   |-- TARGET_linux-sh.mk

|   |   |-- TARGET_linux-x86.mk

|   |   |-- arch

|   |   |   `-- arm

|   |   |       |-- armv4t.mk

|   |   |       |-- armv5te-vfp.mk

|   |   |       |-- armv5te.mk

|   |   |       |-- armv7-a-neon.mk

|   |   |       `-- armv7-a.mk

|   |   |-- javac.mk

|   |   `-- select.mk

|   |-- config.mk

|   |-- copy_headers.mk

|   |-- definitions.mk

|   |-- device.mk

|   |-- distdir.mk

|   |-- droiddoc.mk

|   |-- dynamic_binary.mk

|   |-- envsetup.mk

|   |-- executable.mk

|   |-- filter_symbols.sh

|   |-- find-jdk-tools-jar.sh

|   |-- host_executable.mk

|   |-- host_java_library.mk

|   |-- host_prebuilt.mk

|   |-- host_shared_library.mk

|   |-- host_static_library.mk

|   |-- java.mk

|   |-- java_library.mk

|   |-- key_char_map.mk

|   |-- main.mk

|   |-- multi_prebuilt.mk

|   |-- node_fns.mk

|   |-- notice_files.mk

|   |-- package.mk

|   |-- pathmap.mk

|   |-- prebuilt.mk

|   |-- prelink-linux-arm-2G.map

|   |-- prelink-linux-arm.map

|   |-- process_wrapper.sh

|   |-- process_wrapper_gdb.cmds

|   |-- process_wrapper_gdb.sh

|   |-- product.mk

|   |-- product_config.mk

|   |-- proguard.flags

|   |-- proguard_tests.flags

|   |-- raw_executable.mk

|   |-- raw_static_library.mk

|   |-- root.mk

|   |-- shared_library.mk

|   |-- static_java_library.mk

|   |-- static_library.mk

|   |-- tasks

|   |   |-- apicheck.mk

|   |   |-- cts.mk

|   |   |-- product-graph.mk

|   |   `-- sdk-addon.mk

|   `-- version_defaults.mk

|-- envsetup.sh

|-- libs

|   `-- host

|       |-- Android.mk

|       |-- CopyFile.c

|       |-- include

|       |   `-- host

|       |       |-- CopyFile.h

|       |       |-- Directories.h

|       |       `-- pseudolocalize.h

|       |-- list.java

|       `-- pseudolocalize.cpp

|-- target

|   |-- board

|   |   |-- Android.mk

|   |   |-- emulator

|   |   |   |-- AndroidBoard.mk

|   |   |   |-- BoardConfig.mk

|   |   |   |-- README.txt

|   |   |   |-- tuttle2.kcm

|   |   |   `-- tuttle2.kl

|   |   |-- generic

|   |   |   |-- AndroidBoard.mk

|   |   |   |-- BoardConfig.mk

|   |   |   |-- README.txt

|   |   |   |-- system.prop

|   |   |   |-- tuttle2.kcm

|   |   |   `-- tuttle2.kl

|   |   `-- sim

|   |       |-- AndroidBoard.mk

|   |       `-- BoardConfig.mk

|   `-- product

|       |-- AndroidProducts.mk

|       |-- core.mk

|       |-- full.mk

|       |-- generic.mk

|       |-- languages_full.mk

|       |-- languages_small.mk

|       |-- sdk.mk

|       |-- security

|       |   |-- README

|       |   |-- media.pk8

|       |   |-- media.x509.pem

|       |   |-- platform.pk8

|       |   |-- platform.x509.pem

|       |   |-- shared.pk8

|       |   |-- shared.x509.pem

|       |   |-- testkey.pk8

|       |   `-- testkey.x509.pem

|       `-- sim.mk
Android编译大全（五）
6.1.2.make文件分类

²  配置类

主要用来配置product、board，以及根据你的Host和Target选择相应的工具以及设定相应的通用编译选项：

config文件
   

说明

build/core/config.mk
   

Config文件的概括性配置

build/core/envsetup.mk
   

generate目录构成等配置

build/target/product
   

产品相关的配置

build/target/board
   

硬件相关的配置

build/core/combo
   

编译选项配置

 

这里解释下这里的board和product。board主要是设计到硬件芯片的配置，比如是否提供硬件的某些功能，比如说GPU等等，或者芯片支持浮点 运算等等。product是指针对当前的芯片配置定义你将要生产产品的个性配置，主要是指APK方面的配置，哪些APK会包含在哪个product中，哪 些APK在当前product中是不提供的。

 

config.mk是一个总括性的东西，它里面定义了各种module编译所需要使用的HOST工具以及如何来编译各种模块，比如说 BUILT_PREBUILT就定义了如何来编译预编译模块。envsetup.mk主要会读取由envsetup.sh写入环境变量中的一些变量来配置 编译过程中的输出目录，combo里面主要定义了各种Host和Target结合的编译器和编译选项。

 

²  模块组织类

这类文件主要定义了如何来处理Module的Android.mk，以及采用何种方式来生成目标模块，这些模块生成规则都定义在config.mk里面。我们可以看看：

CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk

BUILD_HOST_STATIC_LIBRARY:=$(BUILD_SYSTEM)/host_static_library.mk

BUILD_HOST_SHARED_LIBRARY:=$(BUILD_SYSTEM)/host_shared_library.mk

      BUILD_STATIC_LIBRARY:=$(BUILD_SYSTEM)/static_library.mk

      BUILD_RAW_STATIC_LIBRARY :=$(BUILD_SYSTEM)/raw_static_library.mk

      BUILD_SHARED_LIBRARY:=$(BUILD_SYSTEM)/shared_library.mk

      BUILD_EXECUTABLE:= $(BUILD_SYSTEM)/executable.mk

      BUILD_RAW_EXECUTABLE:=$(BUILD_SYSTEM)/raw_executable.mk

      BUILD_HOST_EXECUTABLE:=$(BUILD_SYSTEM)/host_executable.mk

      BUILD_PACKAGE:= $(BUILD_SYSTEM)/package.mk

      BUILD_HOST_PREBUILT:=$(BUILD_SYSTEM)/host_prebuilt.mk

      BUILD_PREBUILT:= $(BUILD_SYSTEM)/prebuilt.mk

      BUILD_MULTI_PREBUILT:=$(BUILD_SYSTEM)/multi_prebuilt.mk

      BUILD_JAVA_LIBRARY:= $(BUILD_SYSTEM)/java_library.mk

      BUILD_STATIC_JAVA_LIBRARY:=$(BUILD_SYSTEM)/static_java_library.mk

      BUILD_HOST_JAVA_LIBRARY:=$(BUILD_SYSTEM)/host_java_library.mk

      BUILD_DROIDDOC:= $(BUILD_SYSTEM)/droiddoc.mk

      BUILD_COPY_HEADERS := $(BUILD_SYSTEM)/copy_headers.mk

      BUILD_KEY_CHAR_MAP :=$(BUILD_SYSTEM)/key_char_map.mk    

除了CLEAR_VARS是清楚本地变量之外，其他所有的都对应了一种模块的生成规则，每一个本地模块最后都会include其中的一种来生成目标模块。 大部分上面的.mk都会包含base_rules.mk，这是对模块进行处理的基础文件，建议要写本地模块的都去看看，看明白了为什么 Android.mk要这么写就会大致明白了。

²  单个模块编译类

本地模块的Makefile文件就是我们在Android里面几乎上随处可见的Android.mk。Android进行编译的时候会通过下面的函数来遍 历所有子目录中的Android.mk，一旦找到就不会再往层子目录继续寻找(所有你的模块定义的顶层Android.mk必须包含自己定义的子目录中的 Android.mk)。

  subdir_makefiles += \

         $(shellbuild/tools/findleaves.sh --prune="./out" $(subdirs) Android.mk)

不同类型的本地模块具有不同的语法，但基本上是相通的，只有个别变量的不同，如何添加模块在前面的帖子已经说过了，大家可以参考。

 

Android通过LOCAL_MODULE_TAGS来决定哪些本地模块会不会编译进系统，通过PRODUCT和LOCAL_MODULE_TAGS来 决定哪些应用包会编译进系统，如果用户不指定LOCAL_MODULE_TAGS，默认它的值是user。此外用户可以通过buildspec.mk来指 定你需要编译进系统的模块。用户也可以通过mm来编译指定模块，或者通过make clean-module_name来删除指定模块。

 

²  系统生成类

这主要指的是build/core/Makefile这个文件，它定义了生成各种img的方式，包括ramdisk.img   userdata.img system.img  update.zip  recover.img等。我们可以看看这些img都是如何生成的，对应着我们常用的几个make goals。

 

在实际的过程中，我们也可以自己编辑out目录下的生成文件，然后手工打包相应生成

相应的img，最常用的是加入一些需要集成进的prebuilt file。所有的Makefile都通过build/core/main.mk这个文件组织在一起，它定义了一个默认goals：droid，当我们在 TOP目录下敲Make实际上就等同于我们执行make droid。当Make include所有的文件，完成对所有make文件的解析以后就会寻找生成droid的规则，依次生成它的依赖，直到所有满足的模块被编译好，然后使用相 应的工具打包成相应的img。
Android编译大全（六）
6.2. makefile文件

控制整个android系统编译的make文件。其内容如下：

### DO NOT EDIT THIS FILE ###

include build/core/main.mk

### DO NOT EDIT THIS FILE ###

 

可以看出，实际上控制编译的文件是：build/core/main.mk
6.3. Make命令

²  make droid：等同于make命令。droid是默认的目标名称。

²  make all：  make all将make所有make droid会编译的项目。同时，将编译LOCAL_MODULE_TAGS定义的不包括android tag的模块。这将确保所有的在代码树里面同时有Android.mk文件的模块。

²  clean-$(LOCAL_MODULE)和clean-$(LOCAL_PACKAGE_NAME)：

删除某个模块的目标文件。例如：clean-libutils将删除所有的libutils.so以及和它相关的中间文件；clean-Home将删除Home应用。

²  make clean：删除本次配置所编译输出的结果文件。类似于：rm –rf ./out/

²  make clobber：删除所有配置所编译输出的结果文件。类似于：rm –rf ./out/

²  make dataclean：make dataclean deletes contents of the data directory inside the current combo directory. This is especially useful on the simulator and emulator, where the persistent data remains present between builds.

²  make showcommands：在编译的时候显示脚本的命令，而不是显示编译的简报。用于调试脚本。

²  make LOCAL_MODULE：编译一个单独得模块（需要有Android.mk文件存在）。

²  make targets：将输出所有拟可以编译的模块名称列表。

 

注：还有一些命令，从make文件里面应该可以找到。本文不做探讨。
6.4. build/core/config.mk

config.mk文件的主要内容如下：

Ø  头文件的定义；（各种include文件夹的设定）

在定义头文件的部分，还include了pathmap.mk，如下：

include $(BUILD_SYSTEM)/pathmap.mk

该文件设置include目录和frameworks/base下子目录等的信息。

Ø  编译系统内部mk文件的定义；

Ø  设定通用的名称；

Ø  Include必要的子配置文件；

n  buildspec.mk

n  envsetup.mk

n  BoardConfig.mk

n  /combo/select.mk

n  /combo/javac.mk

Ø  检查BUILD_ENV_SEQUENCE_NUMBER版本号；

In order to make easier for people when the build system changes, when it is necessary to make changes to buildspec.mk or to rerun the environment setup scripts, they contain a version number in the variable BUILD_ENV_SEQUENCE_NUMBER. If this variable does not match what the build system expects, it fails printing an error message explaining what happened. If you make a change that requires an update, you need to update two places so this message will be printed.

·         In config/envsetup.make, increment the CORRECT_BUILD_ENV_SEQUENCE_NUMBER definition.

·         In buildspec.mk.default, update the BUILD_ENV_SEQUENCE_DUMBER definition to match the one in config/envsetup.make

The scripts automatically get the value from the build system, so they will trigger the warning as well.

Ø  设置常用工具的常量；< Generic tools.>

Ø  设置目标选项；< Set up final options.>

Ø  遍历并设置SDK版本；
Android编译大全（七）
6.5. buildspec.mk

默认情况下，buildspec.mk文件是不存在的，表示使用的多少默认选项。Android只提供了buildspec.mk文件的模板文件 build/buildspec.mk.default。如果需要使用buildspec.mk文件，请将该文件拷贝到根目 录下面，并命名为buildspec.mk。同时，需要将模板文件里面的一些必要的配置项启用或者修改为你所需要的目标选项。

 

buildspec.mk文件主要配置下面的选项：

Ø  TARGET_PRODUCT：设置编译之后的目标（产品）类型；

可以设置的值在：build/target/product/中定义。比如，product目录下有下面几个mk文件：

²  AndroidProducts.mk

²  core.mk

²  full.mk

²  generic.mk

²  languages_full.mk

²  languages_small.mk

²  sdk.mk

²  sim.mk

那么，在这里可以设置的值就为上面几个mk文件的前缀名称（generic等）。

Ø  TARGET_BUILD_VARIANT：设置image的类型；

包括三个选项：user、userdebug、eng。

usr：                     出厂时候面向用户的image；

userdebug：      打开了一些debug选项的image；

eng：                  为了开发而包含了很多工具的image

Ø  CUSTOM_MODULES：设置额外的总是会被安装到系统的模块；

这里设置的模块名称采用的是简单目标名，比如：Browser或者MyApp等。这些名字在LOCAL_MODULE或者在LOCAL_PACKAGE_NAME里面定义的。

LOCAL_MODULE is the name of what's supposed to be generated from your Android.mk. For exmample, for libkjs, the LOCAL_MODULE is "libkjs" (the build system adds the appropriate suffix -- .so .dylib .dll). For app modules, use LOCAL_PACKAGE_NAME instead of LOCAL_MODULE. We're planning on switching to ant for the apps, so this might become moot.

Ø  TARGET_SIMULATOR：设置是否要编译成simulator ；

Ø  TARGET_BUILD_TYPE：设置是debug还是release版本 ；

Set this to debug or release if you care.  Otherwise, it defaults to release for arm and debug for the simulator.

Ø  HOST_BUILD_TYPE：设置Host目标是debug版还是release版；



Ø  DEBUG_MODULE_ModuleName：配置单个模块的版本是debug还是release；

Ø  TARGET_TOOLS_PREFIX：工具名前缀，默认为NULL

Ø  HOST_CUSTOM_DEBUG_CFLAGS/ TARGET_CUSTOM_DEBUG_CFLAGS：增加额外的编译选项LOCAL_CFLAGS。

LOCAL_CFLAGS：If you have additional flags to pass into the C or C++ compiler, add them here. For example: LOCAL_CFLAGS += -DLIBUTILS_NATIVE=1

Ø  CUSTOM_LOCALES：增加额外的LOCALES到最总的image；

Any locales that appear in CUSTOM_LOCALES but not in the locale list for the selected product will be added to the end of PRODUCT_LOCALES.

Ø  OUT_DIR：编译之后文件保存路径。默认为/out目录；

Ø  ADDITIONAL_BUILD_PROPERTIES：指定（增加）额外的属性文件；

Ø  NO_FALLBACK_FONT：设置是否只支持英文（这将减少image的大小）。

Ø  WEBCORE_INSTRUMENTATION：webcore支持；

Ø  ENABLE_SVG：SVG支持；

Ø  BUILD_ENV_SEQUENCE_NUMBER：编译系列号；


转自：http://quanminchaoren.iteye.com/blog/840917