android编译系统
来源:互联网 发布:iphone47.12优化 编辑:程序博客网 时间:2024/05/02 20:53
Android Makefile 文件讲解
android编译系统的makefile文件Android.mk写法如下
(1) Android.mk文件首先需要指定LOCAL_PATH变量,用于查找源文件。由于一般情况下
Android.mk和需要编译的源文件在同一目录下,宏函数“my-dir”由编译系统提供的,用于返回当前路径。所以定义成如下形式:
LOCAL_PATH:=$(call my-dir)
上面的语句的意思是将LOCAL_PATH变量定义成本文件所在目录路径。
(2) Android.mk中可以定义多个编译模块,每个编译模块都是以include $(CLEAR_VARS)开始
以include $(BUILD_XXX)结束。
include $(CLEAR_VARS)
CLEAR_VARS由编译系统提供,指定让GNUMAKEFILE为你清除除LOCAL_PATH以外的所有LOCAL_XXX变量,
如LOCAL_MODULE,LOCAL_SRC_FILES,LOCAL_SHARED_LIBRARIES,LOCAL_STATIC_LIBRARIES等。
include $(BUILD_STATIC_LIBRARY)表示编译成静态库
include $(BUILD_SHARED_LIBRARY)表示编译成动态库
include $(BUILD_EXECUTABLE)表示编译成可执行程序
include $(BUILD_PREBUILT)
对于Android系统集成有源码的第三方库和程序,只需要提供Android.mk文件,把源码集成到 Android编译系统中就可以了,并且有很多例子可以参考。但是对于没有源码的pre-build第三方库和程序,采用include $(BUILD_PREBUILT)或者include $(BUILD_MULTI_PREBUILT),参考文章:
http://blog.csdn.net/zhangchiytu/article/details/6424910
include $(BUILD_JAVA_LIBRARY)表示生成JAR包
include $(BUILD_PACKAGE)表示编译成APK
在“include $(BUILD_STATIC_LIBRARY)表示编译成静态库,include $(BUILD_SHARED_LIBRARY)表示编译成动态库,include $(BUILD_EXECUTABLE)表示编译成可执行程序”之前必须要定义LOCAL_MODULE变量,这样编译系统才会知道要生成的静态库、动态库、可执行程序的名称,编译系统会根据类型自动加载后缀。
(3) LOCAL_MODULE_TAGS:= optional
LOCAL_MODULE_TAGS :=user eng tests optional
user: 指该模块只在user版本下才编译
eng: 指该模块只在eng版本下才编译
tests: 指该模块只在tests版本下才编译
optional:指该模块在所有版本下都编译
(4) LOCAL_SRC_FILES: 编译的源代码文件列表
添加src目录下所有的java 源文件:LOCAL_SRC_FILES:= $(call all-java-files-under, src)
(5) LOCAL_SDK_VERSION := current
(6) LOCAL_MODULE:= 模块名称,见(2)中描述。
(7) LOCAL_PACKAGE_NAME :=APK 包的名称
(8) LOCAL_JAVA_LIBRARIES :=platform core ext 依赖的共享jar
(9) LOCAL_STATIC_JAVA_LIBRARIES := 依赖的静态jar包 (jar包是使用 include $(BUILD_STATIC_JAVA_LIBRARY)生成的。)
(10) LOCAL_CERTIFICATE: 签名认证 1.系统中所有使用android.uid.system作为共享UID的APK,都会首先在manifest节点中增加android:sharedUserId="android.uid.system",然后在Android.mk中增加LOCAL_CERTIFICATE:= platform。 2. 系统中所有使用android.uid.shared作为共享UID的APK,都会在manifest节点中增加android:sharedUserId="android.uid.shared",然后在Android.mk中增加LOCAL_CERTIFICATE:= shared。 3.系统中所有使用android.media作为共享UID的APK,都会在manifest节点中增加android:sharedUserId="android.media",然后在Android.mk中增加LOCAL_CERTIFICATE:= media
(11) 编译一个应用程序(APK)
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# Build all java files in the java subdirectory
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# Name of the APK to build
LOCAL_PACKAGE_NAME := LocalPackage
# Tell it to build an APK
include $(BUILD_PACKAGE)
(12) 编译静态库
#清除java环境变量
include$(CLEAR_VARS)
LOCAL_MODULE_TAGS:= user
#添加aidl文件
LOCAL_SRC_FILES+= src/net/sunniwell/download/aidl/IDownload.aidl
# SDK 版本
LOCAL_SDK_VERSION:= current
#jar包的名字
LOCAL_MODULE:=DownLoadServerapi
#编译 DownLoadServerapi jar 包
include $(BUILD_STATIC_JAVA_LIBRARY)
(13) 编译一个依赖于静态Java库(static.jar)的应用程序
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# List of static libraries to include in the package
LOCAL_STATIC_JAVA_LIBRARIES := DownLoadServerapi 第三方jar包
# Build all java files in the java subdirectory
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# Name of the APK to build
LOCAL_PACKAGE_NAME := LocalPackage
# Tell it to build an APK
include $(BUILD_PACKAGE)
(14) 编译一个需要用平台的key签名的应用程序
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# Build all java files in the java subdirectory
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# Name of the APK to build
LOCAL_PACKAGE_NAME := LocalPackage
LOCAL_CERTIFICATE := platform
# Tell it to build an APK
include $(BUILD_PACKAGE)
(15) 添加一个静态JAVA库
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
# Build all java files in the java subdirectory
LOCAL_SRC_FILES := $(call all-subdir-java-files)
# Any libraries that this library depends on
LOCAL_JAVA_LIBRARIES := android.test.runner
# The name of the jar file to create
LOCAL_MODULE := sample
# Build a static jar file.
include $(BUILD_STATIC_JAVA_LIBRARY)
(16) 引用第三方JAR 包方式
#引入第三方包
include $(CLEAR_VARS)
# 表示在当前目录下的lib/iptv.jar进行预处理到android jar包的目录中去
#LOCAL_PREBUILT_JAVA_LIBRARIES := libiptv:lib/iptv.jar
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := \
libiptv:lib/iptv.jar
include $(BUILD_MULTI_PREBUILT)
需要在编译apk 中进行、并添加
LOCAL_STATIC_JAVA_LIBRARIES := libiptv
(17) LOCAL_AIDL_INCLUDES := <path to aidl files>
aidl文件所在的目录,关于aidl是Android Interface definition language的缩写,它是一种android内部进程通信接口的描述语言,通过它我们可以定义进程间的通信接口
(18)include $(call all-makefiles-under,$(LOCAL_PATH))
在Android的源代码中的mk文件中,我们经常会看到上面这句话,从字面意思看是,include目录下所有的mk文件,那么这里面有两个坑,
1.只是include Android.mk文件,叫其他名字的mk文件,不include.
2.只是include这个$(LOCAL_PATH)一级目录下的Android.mk文件,而不是所有子目录以及子目录下的Android.mk文件(这个坑掉进去2小时才出来 )。
最后,看一下这个函数的源代码加强一下印象吧:
define all-makefiles-under
$(wildcard $(1)/*/Android.mk)
endef
(19) LOCAL_PRELINK_MODULE
动态链接和加载的过程开销很大,并且在大多数的系统上, 函数库并不会常常被更动, 每次程序被执行时所进行的链接动作都是完全相同的,对于嵌入式系统来说尤其如此。因此,这一过程可以改在运行时之前就可以预先处理好,即花一些时间利用Prelink工具对动态共享库和可执行文件进行处理,修改这些二进制文件并加入相应的重定位等信息,节约了本来在程序启动时的比较耗时的查询函数地址等工作,这样可以减少程序启动的时间,同时也减少了内存的耗用。
(20)
Android编译系统详解(一)
http://blog.csdn.net/mr_raptor/article/details/7539978
Android的优势就在于其开源,手机和平板生产商可以根据自己的硬件进行个性定制自己的手机产品,如小米,LePhone,M9等,因此,在我们在对Android的源码进行定制的时候,很有必要了解下,Android的编译过程。
如果你从来没有做过Android代码的编译,那么最官方的编译过程就是查看Android的官方网站:http://source.android.com/source/building.html
但是,这儿只是告诉你了如何去编译一个通用的系统,并没有详细告诉你细节,我们跟着编译过程来了解下。
+-------------------------------------------------------------------------------------------------+
+-------------------------------------------------------------------------------------------------+
按照google给出的编译步骤如下:
我们按照编译步骤来分析编译过程的细节,最终添加自己的平台编译选项。
1. source build/envsetup.sh
这个命令是用来将envsetup.sh里的所有用到的命令加载到环境变量里去,我们来分析下它。
envsetup.sh里的主要命令如下:
function help() # 显示帮助信息
function get_abs_build_var() # 获取绝对变量
function get_build_var() # 获取绝对变量
function check_product() # 检查product
function check_variant() # 检查变量
function setpaths() # 设置文件路径
function printconfig() # 打印配置
function set_stuff_for_environment()
function set_sequence_number()
function settitle() # 设置标题
function choosetype() # 设置type
function chooseproduct()
function choosevariant()
function tapas()
function choosecombo()
function add_lunch_combo()
function print_lunch_menu() # 打印lunch列表
function lunch() # 配置lunch
function m() # make from top
function findmakefile() # 查找makefile
function mm() # make from current directory
function mmm()
function croot() # 回到根目录
function cproj()
function pid()
function systemstack()
function gdbclient()
function jgrep() # 查找java文件
function cgrep()
function resgrep()
function tracedmdump()
function runhat()
function getbugreports()
function startviewserver()
function stopviewserver()
function isviewserverstarted()
function smoketest()
function runtest()
function godir () #跳到指定目录
# files are included at the end of this file.
unset LUNCH_MENU_CHOICES
function add_lunch_combo(){
}
# 这是系统自动增加了一个默认的编译项 generic-eng
# add the default one here
add_lunch_combo generic-eng
# if we're on linux, add the simulator.
# in lunch to deal with the simulator
if [ "$(uname)" = "Linux" ] ; then
fi
# 下面的代码很重要,它要从vendor目录下查找vendorsetup.sh文件,如果查到了,就加载它
# Execute the contents of any vendorsetup.sh files we can find.
for f in `/bin/ls vendorbuild/vendorsetup.sh 2> /dev/null` #android4.0中也会检查/device/目录下是否有vendorsetup.sh
do
done
unset f
envsetup.sh其主要作用如下:
1. 加载了编译时使用到的函数命令,如:help,lunch,m,mm,mmm等
2. 添加了两个编译选项:generic-eng和simulator,这两个选项是系统默认选项
3. 查找vendor/<-厂商目录>/和vendor/<厂商目录>/build/目录下的vendorsetup.sh,如果存在的话,加载执行它,添加厂商自己定义产品的编译选项
根据上面的内容,可以推测出,如果要想定义自己的产品编译项,简单的办法是直接在envsetup.sh最后,添加上add_lunch_combo myProduct-eng,当然这么做,不太符合上面代码最后的本意,我们还是老实的在vendor目录下创建自己公司名字,然后在公司目录下创建一个新的vendorsetup.sh,在里面添加上自己的产品编译项。
#mkdir vendor/farsight/
#touch vendor/farsight/vendorsetup.sh
#echo "add_lunch_combo fs100-eng" > vendor/farsight/vendorsetup.sh
这样,当我们在执行source build/envsetup.sh命令的时候,可以在shell上看到下面的信息:
including vendor/farsight/vendorsetup.sh
2. 按照android官网的步骤,开始执行lunch full-eng
当然如果你按上述命令执行,它编译的还是通用的eng版本系统,不是我们个性系统,我们可以执行lunch命令,它会打印出一个选择菜单,列出可用的编译选项
如果你按照第一步中添加了vendorsetup.sh那么,在命令行中执行lunch:
#lunch
那么会显示如下信息:
You're building on Linux
Lunch menu... pick a combo:
其中第3项是我们自己添加的编译项。
因此如果想配置fs100-eng,则执行“lunch fs100-eng”或者“lunch 3”
lunch命令是envsetup.sh里定义的一个命令,用来让用户选择编译项,来定义Product和编译过程中用到的全局变量。
我们一直没有说明前面的fs100-eng是什么意思,现在来说明下,fs100是我定义的产品的名字,eng是产品的编译类型,除了eng外,还有user, userdebug,分别表示:
eng: 工程机,
user:最终用户机
userdebug:调试测试机
tests:测试机
由此可见,除了eng和user外,另外两个一般不能交给最终用户的,记得m8出来的时候,先放出了一部分eng工程机,然后出来了user机之后,可以用工程机换。
那么这四个类型是干什么用的呢?其实,在main.mk里有说明,在Android的源码里,每一个目标(也可以看成工程)目录都有一个Android.mk的makefile,每个目标的Android.mk中有一个类型声明:LOCAL_MODULE_TAGS,这个TAGS就是用来指定,当前的目标编译完了属于哪个分类里。
好了,我们来分析下lunch命令干了什么?
function lunch()
{