ANDROID Porting系列一、ANDROID编译系统
译自：http://source.android.com/porting/build_system.html
Android使用一个自定义生成系统生成工具，二进制文件和文档。本文档提供了一个建立Android的编译系统的概述。
Android的编译系统需要最新版本的GNU make, （请注意，Android使用GNU的先进功能，可能使用还没有出现在网站的GNU Make）。在继续之前，请通过运行％make –v。查询您的make版本。如果您不具有版本3.80或更高版本，您需要升级您的make版本。
了解Makefile
Makefile定义了如何建立一个特定的应用程序。 Makefile文件通常包括下列全部内容：
Name：给你建立一个名称（LOCAL_MODULE：= <build_name>）。
Local Variables：用CLEAR_VARS清除局部变量(include $(CLEAR_VARS)).。
Files：确定哪些文件取决于您的应用程序（LOCAL_SRC_FILES：= main.c）。
Tags：定义标记，如必要（LOCAL_MODULE_TAGS：=eng development）。
Libraries：定义您的应用程序是否与其他libraries链接（LOCAL_SHARED_LIBRARIES：= cutils）。
Template file：包含一个模板文件来定义，强调为特定目标（工具包括$（BUILD_EXECUTABLE））。
下面的代码段演示了一个典型的Makefile。
LOCAL_PATH := $(my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := <buil_name>
LOCAL_SRC_FILES := main.c
LOCAL_MODULE_TAGS := eng development
LOCAL_SHARED_LIBRARIES := cutils
include $(BUILD_EXECUTABLE)
(HOST_)EXECUTABLE, (HOST_)JAVA_LIBRARY, (HOST_)PREBUILT, (HOST_)SHARED_LIBRARY,
(HOST_)STATIC_LIBRARY, PACKAGE, JAVADOC, RAW_EXECUTABLE, RAW_STATIC_LIBRARY,
COPY_HEADERS, KEY_CHAR_MAP
上述片段包括artificial line breaks，以保持一个print-friendly打印文件。
层
构建层次结构包括抽象如下表所述层。
每一层关系到它上面的一个一对多的关系之一。例如，arch可以有多个board，每board可以有一个以上的device。你可以定义一个作为一个在同层元素专业化给定的层元素，从而消除复制和简化维护。
|
Layer |
Example |
Description |
|
Product |
myProduct, myProduct_eu, myProduct_eu_fr, j2, sdk |
该产品层定义了一船产品规格齐全，界定哪些模块，来构建，以及如何配置它们。你可能会在几个不同的版本提供的设备的基础上的区域设置，例如，或在功能，如照相机。 |
|
Device |
myDevice, myDevice_eu, myDevice_eu_lite |
该device层代表设备上的塑料的物理层。例如，北美的设备可能包括销售设备，而在法国的QWERTY键盘可能包括AZERTY键盘。外设通常连接到device层。 |
|
Board |
sardine, trout, goldfish |
board层代表一个产品的原理图。您可能仍然连接外设的board层. |
|
Arch |
arm (arm5te) (arm6), x86, 68k |
arch层描述了处理器运行在您的board上。 |
在Android平台的建设
本节介绍了如何建立在Android的默认版本。一旦你建立了一个通用的舒适，那么你可以开始修改自己的目标设备的机器人。
设备代码
为了做一个机器人通用建设，源建设/ envsetup.sh，其中包含必要的变量和函数的定义，分述如下。
% cd $TOP
% . build/envsetup.sh
# pick a configuration using choosecombo
% choosecombo
% make -j4 PRODUCT-generic-user
您也可以替换为用户调试project:
% make -j4 PRODUCT-generic-eng
这些建立在不同的变体和包安装调试选项条件。
清理
执行% m clean，清理你刚刚创建的二进制文件。您也可以执行% m clobber获得的所有连击的二进制文件清除。 % m clobber等同于删除/ /输出/目录下生成的所有文件的存储位置。
加快重新build
每个组合的二进制文件存储为不同的子/ /输出/，从而能够迅速连击之间切换，而不必每次都重新编译所有的源目录。
但是，执行干净重建是必要的，如果不生成系统捕捉到的环境变量或生成文件的变化。如果发生这种情况时候，你应该定义如下所示USE_CCACHE环境变量：
% export USE_CCACHE=1
这样做将迫使编译系统的编译器使用ccache的缓存工具，从而降低重新编译所有来源。
ccache的二进制文件中提供/ /预置/ ...也不需要让您的系统上安装。
疑难解答
下面的错误可能是由运行的Java过时的版本引起的。
device Dex: core UNEXPECTED TOP-LEVEL ERROR:
java.lang.NoSuchMethodError: method java.util.Arrays.hashCode with
signature ([Ljava.lang.Object;)I was not found.
at com.google.util.FixedSizeList.hashCode(FixedSizeList.java:66)
at com.google.rop.code.Rop.hashCode(Rop.java:245)
at java.util.HashMap.hash(libgcj.so.7)
[...]
dx是一个Java程序，使用设施，首先在现有的Java版本1.5。在shell执行% java -version检查您使用的Java版本。您应该看到类似：
java version "1.5.0_07"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_07-164)
Java HotSpot(TM) Client VM (build 1.5.0_07-87, mixed mode, sharing)
如果你有Java 1.5或更高版本和您收到此错误，请确认您已正确地更新你的PATH变量。
建设Android内核
本节介绍如何构建Android的默认内核。一旦你建立了一个generic build，那么你可以开始修改自己的Android target设备的驱动程序。
要构建内核的基础上，切换到设备目录（/home/joe/android/device），以建立变量和运行：
% . build/envsetup.sh
% partner_setup generic
然后切换到内核目录/home/joe/android/kernel.。
Checking Out a Branch
The default branch is always android. To check out a different branch, execute the following:
% git checkout --track -b android-mydevice origin/android-mydevice
//Branch android-mydevice set up to track remote branch
% refs/remotes/origin/android-mydevice.
//Switched to a new branch "android-mydevice"
为了简化代码管理，让您的本地branch与远程branch跟踪（如在上述片段所示）相同的名称。通过执行% git checkout <branchname>.在分支之间切换
Verifying Location
找出存在的branch（包括本地和远程）哪个branch active通过执行以下（有星号标记）：
% git branch -a
android
* android-mydevice
origin/HEAD
origin/android
origin/android-mydevice
origin/android-mychipset
只看local branch，省略- a标志.
Building the Kernel
要构建内核，执行：
% make -j4
build变量
当某一产品的build，经常是有用的，什么是最终的最终发布版本略有不同。这是目前定义的build变量：
|
eng |
这是默认的flavor。%make与%make eng一样。 •安装模块标记： eng, debug, user, 或development.。 •安装non-APK模块，没有标记指定。 •安装APKs根据产品定义文件，除了标记的APKs。 •ro.secure = 0 •ro.debuggable = 1 •ro.kernel.android.checkjni = 1 •adb是默认启用的。 |
|
user |
make user 这是意在最终版本位的lavor。 •安装模块用的用户。 •安装non-APK模块，没有标记中指定。 •安装APKs根据产品定义文件，标签被忽略的APK模块。 ro.secure=1 · ro.debuggable=0 · adb is disabled by default. |
|
userdebug |
make userdebug 与 user一样, 除: · 还安装与debug标记模块 . · ro.debuggable=1 · adb is enabled by default. |
如果你建立一个flavor，然后想建一个，你应该运行make installclean，两个make间要保证让你不接受了以前installclean flavor。Make clean也足够了，但它需要的时间更长。
