android build

来源：互联网发布：联合国工作知乎编辑：程序博客网时间：2024/06/08 05:00

本文主要参考官方文档（http://source.android.com/download）和网上相关资料（http://blog.csdn.net/HKjinzhao/archive/2009/03/18/4002326.aspx，http://www.williamhua.com/2009/04/30/how-to-build-android-15-kernel-image/）。网上的资料对于andorid的最新代码有的已经过时，或者有错误，这份文档本人亲自实验，保证可行。另本人没有使用eclipse的习惯，所以并没有做eclipse的相关配置。

编译环境：ubuntu9.10，widnows平台目前不被支持。

1）安装必要的软件环境
$ sudo apt-get install git-core gnupg sun-java5-jdk flex bisongperf libsdl-dev libesd0-dev libwxgtk2.6-dev build-essential zipcurl libncurses5-dev zlib1g-dev
官方推荐的就是上面这些，如果在编译过程中发现某些命令找不到，就apt-get它。可能需要的包还有：
$ sudo apt-get install make
$ sudo apt-get install gcc
$ sudo apt-get install g++
$ sudo apt-get install libc6-dev

$ sudo apt-get install patch
$ sudo apt-get install texinfo

$ sudo apt-get install zlib1g-dev
$ sudo apt-get install valgrind
$ sudo apt-get install python2.5（或者更高版本）
需要注意的是，官方文档说如果用sun-java6-jdk可出问题，得要用sun-java5-jdk。经测试发现，如果仅仅make（make不包括make sdk），用sun-java6-jdk是没有问题的。而makesdk，就会有问题，严格来说是在make doc出问题，它需要的javadoc版本为1.5。
因此，我们安装完sun-java6-jdk后最好再安装sun-java5-jdk，或者只安装sun-java5-jdk。这里sun-java6-jdk和sun-java5-jdk都安装，并只修改javadoc.1.gz和javadoc。因为只有这两个是makesdk用到的。这样的话，除了javadoc工具是用1.5版本，其它均用1.6版本：
$ sudo apt-get install sun-java6-jdk
修改javadoc的link
$ cd /etc/alternatives
$ sudo rm javadoc.1.gz
$ sudo ln -s /usr/lib/jvm/java-1.5.0-sun/man/man1/javadoc.1.gzjavadoc.1.gz
$ sudo rm javadoc
$ sudo ln -s /usr/lib/jvm/java-1.5.0-sun/bin/javadoc javadoc

2）设置环境变量
$ emacs ~/.bashrc
在.bashrc中新增或整合PATH变量，如下：
#java 程序开发/运行的一些环境变量
JAVA_HOME=/usr/lib/jvm/java-6-sun
JRE_HOME=${JAVA_HOME}/jre
export ANDROID_JAVA_HOME=$JAVA_HOME
export CLASSPATH=.:${JAVA_HOME}/lib:$JRE_HOME/lib:$CLASSPATH
export JAVA_PATH=${JAVA_HOME}/bin:${JRE_HOME}/bin
export JAVA_HOME;
export JRE_HOME;
export CLASSPATH;
HOME_BIN=~/bin/
export PATH=${PATH}:${JAVA_PATH}:${HOME_BIN};
保存后，同步更新：
source ~/.bashrc

3）安装repo（用来更新android源码）
创建~/bin目录，用来存放repo程序，如下：
$ cd ~
$ mkdir bin
并加到环境变量PATH中，在第2步中已经加入
下载repo脚本并使其可执行：
$ curl http://android.git.kernel.org/repo>~/bin/repo
$ chmod a+x ~/bin/repo

4）初始化repo
repo是android对git的一个封装，简化了一些git的操作。
创建工程目录：
$ mkdir android
$ cd android
repo初始化
$ repo init -ugit://android.git.kernel.org/platform/manifest.git
在此过程中需要输入名字和email地址。初始化成功后，会显示：
repo initialized in /android
在~/android下会有一个.repo的隐藏目录。

5）同步源代码
$ repo sync
这一步要很久很久

6）编译android源码,并得到~/android/out目录
$ cd ~/andoird
$ make
这一过程很久

7）在模拟器上运行编译好的android
编译好android之后，emulator在~/android/out/host/linux-x86/bin下，ramdisk.img，system.img和userdata.img则在~/android/out/target/product/generic下
$ cd ~/android/out/host/linux-x86/bin
增加环境变量
$ emacs ~/.bashrc
在.bashrc中新增环境变量，如下
#java 程序开发/运行的一些环境变量
exportANDROID_PRODUCT_OUT=~/android/out/target/product/generic
ANDROID_PRODUCT_OUT_BIN=~/android/out/host/linux-x86/bin
exportPATH=${PATH}:${ANDROID_PRODUCT_OUT_BIN}:${ANDROID_PRODUCT_OUT};

最后，同步这些变化：
$ source ~/.bashrc
$ cd ~/android/out/target/product/generic
$ emulator -system system.img -data userdata.img -ramdiskramdisk.img
最后进入android桌面，就说明成功了。

8）编译模块
android中的一个应用程序可以单独编译，编译后要重新生成system.img
在源码目录下执行
$ . build/envsetup.sh （.后面有空格）
就多出一些命令：
- croot:   Changes directory tothe top of the tree.
-m:      Makes from the top of the tree.
-mm:     Builds all of the modules in the current directory.
-mmm:    Builds all of the modules in the supplied directories.
- cgrep:   Greps on all localC/C++ files.
- jgrep:   Greps on all localJava files.
- resgrep: Greps on all local res/*.xml files.
- godir:   Go to the directorycontaining a file.
可以加—help查看用法
我们可以使用mmm来编译指定目录的模块，如编译联系人：
$ mmm packages/apps/Contacts/
编完之后生成两个文件：
out/target/product/generic/data/app/ContactsTests.apk
out/target/product/generic/system/app/Contacts.apk
可以使用
$ make snod
重新生成system.img，再运行模拟器

9）编译SDK
直接执行make是不包括make sdk的。makesdk用来生成SDK，这样，我们就可以用与源码同步的SDK来开发android了。

a）修改/frameworks/base/include/utils/Asset.h
‘UNCOMPRESS_DATA_MAX = 1 * 1024 * 1024’ 改为 ‘UNCOMPRESS_DATA_MAX = 2* 1024 * 1024’
原因是eclipse编译工程需要大于1.3M的buffer；

b）编译ADT。
由于本人不使用eclipse，所以没有进行这步；

c）执行make sdk。
注意，这里需要的javadoc版本为1.5，所以你需要在步骤1中同时安装sun-java5-jdk
$ make sdk
编译很慢。编译后生成的SDK存放在out/host/linux-x86/sdk/，此目录下有android-sdk_eng.xxx_linux-x86.zip和android-sdk_eng.xxx_linux-x86目录。android-sdk_eng.xxx_linux-x86就是SDK目录
实际上，当用mmm命令编译模块时，一样会把SDK的输出文件清除，因此，最好把android-sdk_eng.xxx_linux-x86移出来
此后的应用开发，就在该SDK上进行，所以把7）对于~/.bashrc的修改注释掉，增加如下一行：
exportPATH=${PATH}:~/android/out/host/linux-x86/sdk/android-sdk_eng.xxx_linux-x86/tools
注意要把xxx换成真实的路径；

d）关于环境变量、android工具的选择
目前的android工具有：
A、我们从网上下载的SDK，如果你下载过的话（ tools下有许多android工具，lib/images下有img映像）
B、我们用make sdk编译出来的SDK（ tools下也有许多android工具，lib/images下有img映像）
C、我们用make编译出来的out目录（ tools下也有许多android工具，lib/images下有img映像）
那么我们应该用那些工具和img呢？
首先，我们一般不会用A选项的工具和img，因为一般来说它比较旧，也源码不同步。其次，也不会用C选项的工具和img，因为这些工具和img没有经过SDK的归类处理，会有工具和配置找不到的情况；事实上，makesdk产生的很多工具和img，在make编译出来out目录的时候，已经编译产生了，make sdk只是做了copy而已。

e）安装、配置ADT
略过；

f）创建Android Virtual Device
编译出来的SDK是没有AVD（Android Virtual Device）的，我们可以通过android工具查看：
$ android list
创建AVD：
$ android create avd -t 1 -n myavd
可以android –help来查看上面命令选项的用法。创建中有一些选项，默认就行了
再执行android list，可以看到AVD存放的位置
以后每次运行emulator都要加-avd myavd或@myavd选项：
$ emulator -avd myavd

10）编译linux内核映像
a）准备交叉编译工具链
android代码树中有一个prebuilt项目，包含了我们编译内核所需的交叉编译工具。

b）设定环境变量
$ emacs ~/.bashrc
增加如下两行：
exportPATH=$PATH:~/android/prebuilt/linux-x86/toolchain/arm-eabi-4.4.0/bin
export ARCH=arm
保存后，同步变化：
$ source ~/.bashrc

c）获得合适的内核源代码
$ cd ~/android
获得内核源代码仓库
$ git clone git://android.git.kernel.org/kernel/common.gitkernel
$ cd kernel
$ git branch
显示
* android-2.6.27
说明你现在在android-2.6.27这个分支上，也是kernel/common.git的默认主分支。
显示所有head分支：
$ git branch -a
显示
* android-2.6.27
remotes/origin/HEAD -> origin/android-2.6.27
remotes/origin/android-2.6.25
remotes/origin/android-2.6.27
remotes/origin/android-2.6.29
remotes/origin/android-goldfish-2.6.27
remotes/origin/android-goldfish-2.6.29
我们选取最新的android-goldfish-2.6.29，其中goldfish是android的模拟器模拟的CPU。
$ git checkout -b android-goldfish-2.6.29origin/android-goldfish-2.6.29
$ git branch
显示
android-2.6.27
* android-goldfish-2.6.29
我们已经工作在android-goldfish-2.6.29分支上了。

d）设定交叉编译参数
打开kernel目录下的Makefile文件，把CROSS_COMPILE指向刚才下载的prebuilt中的arm-eabi编译器
CROSS_COMPILE ?= arm-eabi-
把
LDFLAGS_BUILD_ID = $(patsubst -Wl$(comma)%,%,\
$(call ld-option, -Wl$(comma)–build-id,))
这一行注释掉，并且添加一个空的LDFLAGS_BUILD_ID定义，如下:
LDFLAGS_BUILD_ID =

e）编译内核映像
$ cd ~/android/kernel
$ make goldfish_defconfig
$ make

f）测试生成的内核映像
$ emulator -avd myavd -kernel~/android/kernel/arch/arm/boot/zImage

Contents [HideShow]

1Android Source Code Download

1.1Website
1.2Create Directory
1.3Donwload Tool Chain
1.4下载Android平台源代码

2编译Android平台以及SDK

2.1完全编译
2.2模块编译
2.3增量编译的步骤

TOPAndroidSource Code Download

TOPWebsite

android的最新源代码下载的官方网站是：http://source.android.com
源代码的下载说明页面是：http://source.android.com/download（现在貌似用还用不了）
现在的网站是http://git.android.com

TOPCreateDirectory

在HOME(/home/justin)目录下创建如下目录结构：

  /home/justin/android:
  总计 36
  drwxr-xr-x 7 justin justin 409601-15 10:34 .
  drwxr-xr-x 58 justin justin12288 01-15 10:39 ..
  drwxr-xr-x 2 justin justin 409601-15 10:34 applications
  drwxr-xr-x 2 justin justin 409601-15 10:33 downloads
  drwxr-xr-x 2 justin justin 409601-15 12:34 bin
  drwxr-xr-x 2 justin justin 409601-15 10:33 sdk
  drwxr-xr-x 2 justin justin 409601-15 10:33 src
  drwxr-xr-x 2 justin justin 409601-15 10:34 tools

将该目录添加到PATH环境变量：

export PATH=$HOME/android/bin:$PATH

如果需要反复使用，需要将这一行加入~/.bashrc启动脚本中

TOPDonwloadTool Chain

TOPGit

Git的版本在1.5.4之上

sudo apt-get install git-core

TOPProxy

安装代理软件：

apt-get install connect-proxy

TOPRepo

repo是包装了git命令的python脚本：

curl http://android.git.kernel.org/repo > ~/android/bin/repo

网关内部需要设置curl代理：

假设网段的（http）代理为：wwwgate.freeshell.net:8080

curl --proxy wwwgate.freeshell.net:8080 http://android.git.kernel.org/repo > ~/android/bin/repo

加上可执行权限

chmod a+x ~/android/bin/repo

TOPPython

Python的版本在2.4之上

sudo apt-get install python

TOPJDK1.6

在下列地址下载： http://java.sun.com/javase/downloads解压得到如下文件： ~/android/downloads/jdk-6u11-linux-i586.bin

cd ~/android/downloads
chmode a+x jdk-6u11-linux-i586.bin

运行这个可执行文件，将生成的目录jdk1.6.0_11拷贝到/usr/local/下

将下列环境变量加入~/.bashrc:

export PATH=/usr/local/jdk1.6.0_11/bin:$PATH
export JAVA_HOME=/usr/local/jdk1.6.0_11
export ANDROID_JAVA_HOME=$JAVA_HOME

TOPOthertools

sudo apt-get install gcc g++

sudo apt-get install flex bison gperf libsdl1.2-dev libesd0-dev libwxgtk2.6-dev \
     build-essential zip curl libncurses5-dev zlib1g-dev valgrind libreadline5-dev

如果因为缺少X11/Xatom.h和X11/Xlib.h导致的build失败，可以安装如下包：

sudo apt-get install x11proto-core-dev  # provides Xatom.h
sudo apt-get install libx11-dev         # provides Xlib.h

TOP交叉编译环境

androidemulator 默认的目标代码是arm7的代码。如果需要将目标代码移植到其他版本的arm平台上去，需要重新配置相应的交叉编译环境。

TOP下载Android平台源代码

1. 初始化要下载的文件列表：

cd ~/android/src
repo init -u git://android.git.kernel.org/platform/manifest.git

如果想检出除master外其他分支上的代码可以用-b选项：

cd ~/android/src
repo init -u git://android.git.kernel.org/platform/manifest.git -b cupcake

2. 配置git帐户

git config --global user.email "xxxxx@xxxxxxx"
git config --global user.name "xxxxxx"

3. 同步文件列表：

repo sync

在第一次下载全部代码完成后，可以按模块更新子项目的代码：

repo sync project-path

其中的project-path可以在src/.repo/manifests/default.xml中找到：

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
  <remote  name="korg"
           fetch="git://android.git.kernel.org/"
           review="review.source.android.com" />
  <default revision="master"
           remote="korg" />

  <project path="build" name="platform/build">
    <copyfile src="http://wonview.blog.163.com/blog/core/root.mk" dest="Makefile" />
  </project>

  <project path="kernel"
           name="kernel/common"
           revision="refs/heads/android-2.6.27" />

  <project path="bionic" name="platform/bionic" />

  <project path="bootable/bootloader/legacy" name="platform/bootable/bootloader/legacy" />
  <project path="bootable/diskinstaller" name="platform/bootable/diskinstaller" />
  <project path="bootable/recovery" name="platform/bootable/recovery" />
  ... ...

在网关内部使用需要设置代理：

新建如下文件：

#!/bin/sh
# /home/justin/android/bin/socks-gw.sh
# This script connects to a HTTP proxy using connect.c
connect -H wwwgate.freeshell.net:8080 $@

#!/bin/sh
# /home/justin/android/bin/socks-ssh.sh
ssh -o ProxyCommand="/home/justin/android/bin/socks-gw.sh %h %p" $@

增加这两个文件的可执行权限：

chmod a+x /home/justin/android/bin/socks-ssh.sh
chmod a+x /home/justin/android/bin/socks-gw.sh

可以将所有代理的环境变量放在：

#!/bin/sh
# /home/justin/proxy.sh

# http proxy setting
export HTTP_PROXY=http://wwwgate.freeshell.net:8080
export http_proxy=$HTTP_PROXY

# set git to use ssh over http proxy
export GIT_SSH="/home/justin/android/bin/socks-ssh.sh"
export GIT_PROXY_COMMAND="/home/justin/android/bin/socks-gw.sh"

需要的时候运行：

. ~/proxy.sh

TOP编译Android平台以及SDK

TOP完全编译

TOP编译映像

cd ~/android/src
make

映像编译成功后会在目录~/android/src/out/target/product/generic下产生一些image文件

ramdisk.img system.img userdata.img android-info.txt

验证，运行这些模块：

export ANDROID_PRODUCT_OUT=/home/justin/android/src/out/target/product/generic
cd out/host/linux-x86/bin
./emulator

TOPSDK编译

在做完一次完全编译后，就可以build SDK了。

make sdk

注意：如果需要build SDK，需要安装sun-java5-jdk,而不是sun-java6-jdk,否则会出现如下错误：

build/core/product_config.mk:207: WARNING: adding test OTA key
============================================
TARGET_PRODUCT=generic
TARGET_BUILD_VARIANT=eng
TARGET_SIMULATOR=
TARGET_BUILD_TYPE=release
TARGET_ARCH=arm
HOST_ARCH=x86
HOST_OS=linux
HOST_BUILD_TYPE=release
BUILD_ID=
============================================
Combining NOTICE files: out/target/product/generic/obj/NOTICE.txt
Finding NOTICE files: out/host/linux-x86/obj/NOTICE_FILES/hash-timestamp
Combining NOTICE files: out/host/linux-x86/obj/NOTICE.txt
Package: out/target/product/generic/generic-img-eng.justin.zip
SDK buildinfo: out/target/product/generic/sdk/sdk-build.prop
Docs droiddoc: out/target/common/docs/dx
javadoc: 错误 - 在 doclet 类 DroidDoc 中，方法 start 已抛出异常 java.lang.reflect.InvocationTargetException
com.sun.tools.javac.code.Symbol$CompletionFailure: 未找到 sun.util.resources.OpenListResourceBundle 的类文件

此时，可以考虑重新安装sun jdk5, 或者直接从http://java.sun.com/javase/downloads下载到~/android/downloads/jdk-1_5_0_17-linux-i586.bin

sudo apt-get install sun-java5-jdk

并设置相应的.bashrc命令。

sdk编译成功后会在~/android/src/out/host/linux-x86/sdk/生成sdk的文件目录和压缩包：

android-sdk_eng.justin_linux-x86
android-sdk_eng.justin_linux-x86.zip

并在~/android/src/out/target/product/generic（generic是默认的产品名）下打包所有的映像文件：

generic-img-eng.justin.zip

生成的SDK目录结构为：

  /home/justin/android/src/out/host/linux-x86/sdk/android-sdk_eng.justin_linux-x86:
  总计 32
  drwxrwx---  6 justin justin 4096 02-13 17:06 .
  drwxr-x---  3 justin justin 4096 02-13 17:09 ..
  drwxrwx---  2 justin justin 4096 02-13 17:06 add-ons
  drwxrwx--- 14 justin justin 4096 02-13 17:06 docs
  -rw-rw----  1 justin justin  172 02-13 17:08 documentation.html
  drwxrwx---  3 justin justin 4096 02-13 17:06 platforms
  -rw-rw----  1 justin justin  225 02-13 17:08 RELEASE_NOTES.txt
  drwxrwx---  3 justin justin 4096 02-13 17:08 tools

安装生成的SDK只需要在.bashrc中增加：

export PATH=$PATH:/home/justin/android/src/out/host/linux-x86/sdk/android-sdk_eng.justin_linux-x86/tools

为了使用方便，将生成的SDK目录链结至~/android/sdk:

ln -sf /home/justin/android/src/out/host/linux-x86/sdk/android-sdk_eng.justin_linux-x86/tools \
       ~/android/sdk

TOP模块编译

在src目录执行：

cd ~/android/src
. build/envsetup.sh

envsetup.sh 提供了一些的bash函数定义，当运行了envsetup.sh后就可以使用help 命令来查看：

help

得到这些命令的帮助信息：

Invoke ". build/envsetup.sh" from your shell to add the following functions to your environment:
- croot:   Changes directory to the top of the tree.
- m:       Makes from the top of the tree.
- mm:      Builds all of the modules in the current directory.
- mmm:     Builds all of the modules in the supplied directories.
- cgrep:   Greps on all local C/C++ files.
- jgrep:   Greps on all local Java files.
- resgrep: Greps on all local res/*.xml files.

Look at the source to view more functions. The complete list is:
add_lunch_combo cgrep check_product check_variant choosecombo chooseproduct choosetype choosevariant croot findmakefile gd
bclient get_abs_build_var getbugreports get_build_var getprebuilt gettop help isviewserverstarted jgrep lunch m mm mmm pid
 printconfig print_lunch_menu resgrep runhat runtest setpaths set_sequence_number set_stuff_for_environment settitle smoke
test startviewserver stopviewserver tapas tracedmdump

其中对模块的编译有帮助的是tapas、m、mm、mmm这几个命令。

1.tapas - 以交互方式设置build环境，以下是运行效果：

tapas

第一步，选择目标设备：

Build for the simulator or the device?
     1. Device
     2. Simulator

Which would you like? [1]

第二步，选择目标代码格式：

Build type choices are:
     1. release
     2. debug

Which would you like? [1]

第三步，选择产品平台：

Product choices are:
     1. emulator
     2. generic
     3. sim
You can also type the name of a product if you know it.
Which would you like? [generic]

第四步，在选用参数下构建平台。

2. 独立模块的构件命令

m: Makes from the top of the tree.
mm: Builds all of the modules in the current directory.
mmm: Builds all of the modules in the supplieddirectories.

其中mmm后面要跟模块的根目录，不是所有的目录下都有子模块，那些含有Android.mk文件目录才是模块的根目录，模块名可以从Android.mk的LOCAL_MODULE或者LOCAL_PACKAGE_NAME变量中得到。

单独编译某模块，需要在mmm后面指定模块路径，例如编译application中的Contacts：

mmm packages/apps/Contacts/

或者在src目录下直接运行make module name：

cd ~/android/src
make Contacts

TOP增量编译的步骤

1. 修改代码

2. 编译所修改的代码所在模块，例如：

cd ~/android/src
mmm packages/apps/Contacts

3. 在~/android/src中运行：

cd ~/android/src
make snod

该命令生成一个新的系统映像system.img

4.将这个系统映像拷贝至sdk下：

cd ~/android/src
cp out/target/product/generic/system.img \
   out/host/linux-x86/sdk/android-sdk_eng.justin_linux-x86/tools/lib/images/

5. 删除程序遗留的数据：

out/host/linux-x86/sdk/android-sdk_eng.justin_linux-x86/tools/emulator -wipe-data

0 0

android&nbsp;build