编写Android.mk中的LOCAL_SRC_FILES的终极技巧

原文

已废弃, 请参考Update:
Android.mk 中的 LOCAL_SRC_FILES, LOCAL_C_INCLUDES

问题的引入

在使用NDK编译C/C++项目的过程中,免不了要编写Android.mk文件,其中最重要的就是

LOCAL_SRC_FILES

源文件列表.

考虑有如下源文件分布的情况:

[code]cpp文件全部位于android项目下的jni文件夹下,结构如下

    jni    
     |---1.cpp
     |---2.cpp
     |---Android.mk
     |---Application.mk
     |---ndk_test.cpp
     |---src    
     |    |---core
     |    |    |---core1.cpp
     |    |    |---core2.cpp
     |    |---src1.cpp
     |    |---src2.cpp

按照通常的写法,在

android.mk

中,应该写入

[code]LOCAL_SRC_FILES := ndk_test.cpp \
                1.cpp \
                2.cpp \
                src/src1.cpp \
                src/src2.cpp \
                src/core/core1.cpp \
                src/core/core2.cpp

繁琐不堪!

初步解法:一句话引入单个目录(不包括子目录)下的所有cpp源文件

继续上面的情况为例,我可以这样写

[code]MY_CPP_LIST := $(wildcard $(LOCAL_PATH)/*.cpp)
MY_CPP_LIST += $(wildcard $(LOCAL_PATH)/src/*.cpp)
MY_CPP_LIST += $(wildcard $(LOCAL_PATH)/src/core/*.cpp)

LOCAL_SRC_FILES := $(MY_CPP_LIST:$(LOCAL_PATH)/%=%)

问题解决.

简单解释一下上面的几句话

MY_CPP_LIST := $(wildcard
 $(LOCAL_PATH)/*.cpp)

,这句话的意思是使用wildcard函数获取$(LOCAL_PATH)目录也就是jni目录下的所有后缀名为cpp的文件,并把结果放到变量

MY_CPP_LIST

里.我们知道$(LOCAL_PATH)指的是当前

Android.mk

文件所在目录,所以通过这句话,

MY_CPP_LIST

中的值应该是

jni/1.cpp
 jni/2.cpp jni/ndk_test.cpp

.

MY_CPP_LIST += $(wildcard
 $(LOCAL_PATH)/src/*.cpp)

, 获取

jni/src

目录下的源文件,并追加到变量

MY_CPP_LIST

里

MY_CPP_LIST += $(wildcard
 $(LOCAL_PATH)/src/core/*.cpp)

,同上,获取

jni/src/core

目录下的源文件

通过以上几步,得到

MY_CPP_LIST

中内容是

jni/1.cpp
 jni/2.cpp jni/ndk_test.cpp jni/src/src1.cpp jni/src/src2.cpp jni/src/core/core1.cpp jni/src/core/core2.cpp

LOCAL_SRC_FILES := $(MY_CPP_LIST:$(LOCAL_PATH)/%=%)

,前面我们获取的文件都是以

jni

开头的,而真正编译所需要的文件都应该是直接从

jni

目录开始的,所以我们使用

模式替换

把所有文件名前面的

jni/

去掉.

这里我解释一下

$(MY_CPP_LIST:$(LOCAL_PATH)/%=%)

的语法含义,它的意思是对

MY_CPP_LIST

中每一项,应用冒号后面的规则,规则是什么呢?规则是

$(LOCAL_PATH)/%=%

,意思是,查找所有

$(LOCAL_PATH)/

开头的项,并截取后面部分

最后一句话也可以使用subst函数写成:

[code]#替换每一项中的 "$(LOCAL_PATH)/" 为 ""(空)
LOCAL_SRC_FILES := $(subst $(LOCAL_PATH)/, , $(MY_CPP_LIST))

或使用patsubst函数写成

[code]#同模式替换,这里使用patsubst函数
LOCAL_SRC_FILES := $(patsubst $(LOCAL_PATH)/%, %, $(MY_CPP_LIST))

具体语法请参考:Functions
for String Substitution and Analysis

实际使用中,可以把代码放在jni目录以外的目录里,这时只要修改wildcard函数里的相对路径就可以了,甚至也可以使用绝对路径,只要你愿意.

以上代码已经足以应付大多数情况了,不过人的懒惰是无极限的,像上面的情况我的所有源文件都在jni目录下,为什么还要把每个子目录都写一行呢,不太优雅呀,最好能写一句话把jni目录下的所有源文件都引入.

进阶:引入单个目录(包括子目录)下的所有cpp源文件

为了达到引入目录下的所有源文件,包括子目录这个目标,我在

android.mk

中这样写

[code]#声明一个变量MY_CPP_PATH表示源码目录
MY_CPP_PATH := $(LOCAL_PATH)/ 

#获取目录下的所有文件    
My_All_Files := $(shell find $(MY_CPP_PATH)/.)
My_All_Files := $(My_All_Files:$(MY_CPP_PATH)/./%=$(MY_CPP_PATH)%)

#从My_All_Files中再次提取所有的cpp文件,这里也可以使用filter函数
MY_CPP_LIST := $(foreach c_file,$(My_All_Files), $(wildcard $(c_file)/*.cpp) ) 
MY_CPP_LIST := $(MY_CPP_LIST:$(LOCAL_PATH)/%=%)

LOCAL_SRC_FILES := $(MY_CPP_LIST)

通过以上几行,成功得到了jni目录包含它的子目录下的所有cpp源文件,并正确编译.实际使用中,代码不一定存放在jni目录下,修改

MY_CPP_PATH

就可以了,注意:

MY_CPP_PATH

最好使用以

$(LOCAL_PATH)

开头的相对目录

这种写法极大的方便了项目的开发,以前在源码目录下新建cpp源文件,新建目录都不需要再来修改

android.mk

文件了.

还有一个问题,上面代码里只是引入cpp文件,如果源码文件夹下还有c文件呢,怎么办?再多写几行?

进阶2.0:引入单个目录(包括子目录)下的所有*.cpp和*.c源文件

这里,我直接给出代码

[code]MY_CPP_PATH  := $(LOCAL_PATH)/
My_All_Files := $(shell find $(MY_CPP_PATH)/.)
My_All_Files := $(My_All_Files:$(MY_CPP_PATH)/./%=$(MY_CPP_PATH)%)
MY_CPP_LIST  := $(filter %.cpp %.c,$(My_All_Files)) 
MY_CPP_LIST  := $(MY_CPP_LIST:$(LOCAL_PATH)/%=%)

LOCAL_SRC_FILES := $(MY_CPP_LIST)

代码中用到了filter函数.

还不满足?如果项目的源码有多个目录放在不同的地方,而且有多个后缀,怎么办?

终极进阶:引入多个目录(包括子目录)下的多个后缀名的源文件

上代码(2013年10月9日修正):

[code]# 扫描目录下的所有源文件
MY_FILES_PATH  :=  $(LOCAL_PATH) \
                   $(LOCAL_PATH)/../../Classes

MY_FILES_SUFFIX := %.cpp %.c %.cc

My_All_Files := $(foreach src_path,$(MY_FILES_PATH), $(shell find $(src_path) -type f) ) 
My_All_Files := $(My_All_Files:$(MY_CPP_PATH)/./%=$(MY_CPP_PATH)%)
MY_SRC_LIST  := $(filter $(MY_FILES_SUFFIX),$(My_All_Files)) 
MY_SRC_LIST  := $(MY_SRC_LIST:$(LOCAL_PATH)/%=%)
LOCAL_SRC_FILES := $(MY_SRC_LIST)

以上代码中,变量

MY_FILES_PATH

保存源文件所在目录,

MY_FILES_SUFFIX

保存源文件的后缀名

原创文章,转载请注明,谢谢!

PS:如何debug 一个android.mk文件

有一个办法,那就是在编译过程输出

android.mk

文件中变量的值,就可以观察分析问题所在了,使用代码

[code]$(warning $(LOCAL_SRC_FILES))

就可以在编译过程中从终端窗口中观察到变量

LOCAL_SRC_FILES

的值