Android Android.mk 文件一点感悟

//Rocky@20110312
Android.mk文件时android 中的一个非常重要的概念。我们有以下几个方便的时候需要使用它。

1：添加新的apk源码文件编译。这里我们先参考下AlarmClock的Android.mk文件

LOCAL_PATH:= $（call my-dir）
include $（CLEAR_VARS）

LOCAL_SRC_FILES := $（call all-subdir-java-files）

LOCAL_PACKAGE_NAME := AlarmClock

include $（BUILD_PACKAGE）

简单的解释下：
第一行，赋予LOCAL_PATH一个新的值，表示当前的路径。
第二行，清楚所有的系统自带的标准变量值。我们通过查找CLEAR_VARS变量定义，可以发现它实际上代表的是
sourceuildcoreconfig.mk中有定义如下：
CLEAR_VARS:= $（BUILD_SYSTEM）/clear_vars.mk
所以查看clear_vars.mk文件可以得到知道：

###########################################################
## Clear out values of all variables used by rule templates.
###########################################################

LOCAL_MODULE:=
LOCAL_MODULE_PATH:=
LOCAL_MODULE_STEM:=
LOCAL_DONT_CHECK_MODULE:=
LOCAL_CHECKED_MODULE:=
LOCAL_BUILT_MODULE:=
LOCAL_BUILT_MODULE_STEM:=
OVERRIDE_BUILT_MODULE_PATH:=
....

它把这些变量都清空了。
注意它这里没有去清空LOCAL_PATH变量。所以这个步骤放在第二行，是没有关系的。它的这个写法有点误导人哈。

第三、四行，给变量赋予新值。这里赋予的是LOCAL_SRC_FILES，LOCAL_PACKAGE_NAME
第五行，执行BUILD_PACKAGE。它的定义也是在config.mk中定义如下：
BUILD_PACKAGE:= $（BUILD_SYSTEM）/package.mk，更多更加具体的，自己去看看吧。

这里其实有很多的，
# ###############################################################
# Build system internal files
# ###############################################################

BUILD_COMBOS:= $（BUILD_SYSTEM）/combo

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

基本上你有用到的就已经提前给你设计好了。你要做的很简单了。

这里的思想其实和makefile的是一样的。

目标：信赖文件
执行命令

只是android在这里进行了高度的封装和简化。
前面四行相当于设置目标文件。
最后一行相当于执行命令。

所以，如果我们要添加自己的apk,就按照这种思想添加就可以了。

2：变量的使用
makefile文件有一个基础的东西就是变量。大家可以自己了解下。这里我们说说android.mk这个变量的不同的地方。主要是用它来做代码管理。这个部分是我同事小强总结出来的，我就cp过来。
替它总结下。

首先在执行make文件的时候这些变量是全局有效的，一些公共的变量会通过include $（CLEAR_VARS）给清除掉。我们这里主要是添加自己的变量。
我们在使用自己定义变量的时候有两种情况，一种是在mk中使用，一种是在cpp中使用。注意java不支持的。
这两种情况有点不同，请注意。

首先我们得定义这个变量，一般来讲都是在产品的BoardConfig.mk中定义，例如：

TARGET_MEMORY_STYLE := TARGET_MEM_256MB
#TARGET_MEMORY_STYLE := TARGET_MEM_256MB_ST
#TARGET_MEMORY_STYLE := TARGET_MEM_512MB
#TARGET_MEMORY_STYLE := TARGET_MEM_512MB_ST

# board-specific configuration
BOARD_OPENCORE_FLAGS := -DTELECHIPS_ALSA

ifeq （$（BOARD_KERNEL_BASE）,0x40000000）
BOARD_MEM_FLAGS := -DTCC_MEM_256MB
else
BOARD_MEM_FLAGS := -DTCC_MEM_512MB
endif

这里总共有两个我们经常用的东西。

第一：

    如果是mk总使用，定义如前四行就可以了。
    变量 := 字符串

    在mk中的使用方法就像后面例子一样。
    ifeq（$（变量）,对比值）

    else

    endif


第二：如果你想在cpp中使用，请定义方式如下

    变量 := -D+变量名

如后面几行示例一样的。

    如果想在cpp中应用，首先必须在cpp对于的mk文件中，声明如下
    LOCAL_CFLAGS += $（BOARD_MEM_FLAGS）

    格式：
    LOCAL_CFLAGS += $（变量）


    然后它的cpp中就可以引用如下：
    此时去掉了-D前缀。

    ifdef TCC_MEM_512MB
    ......
    endif

    特此感谢小强同学的代码控制.doc。