译自: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也足够了,但它需要的时间更长。