已废弃, 请参考Update: Android.mk 中的 LOCAL_SRC_FILES, LOCAL_C_INCLUDES
问题的引入
在使用NDK编译C/C++项目的过程中,免不了要编写Android.mk文件,其中最重要的就是LOCAL_SRC_FILES
源文件列表.
考虑有如下源文件分布的情况:
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
中,应该写入
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源文件
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函数写成:
#替换每一项中的 "$(LOCAL_PATH)/" 为 ""(空)
LOCAL_SRC_FILES := $(subst $(LOCAL_PATH)/, , $(MY_CPP_LIST))
或使用patsubst函数写成
#同模式替换,这里使用patsubst函数
LOCAL_SRC_FILES := $(patsubst $(LOCAL_PATH)/%, %, $(MY_CPP_LIST))
具体语法请参考:Functions for String Substitution and Analysis
实际使用中,可以把代码放在jni目录以外的目录里,这时只要修改wildcard函数里的相对路径就可以了,甚至也可以使用绝对路径,只要你愿意.
以上代码已经足以应付大多数情况了,不过人的懒惰是无极限的,像上面的情况我的所有源文件都在jni目录下,为什么还要把每个子目录都写一行呢,不太优雅呀,最好能写一句话把jni目录下的所有源文件都引入.
进阶:引入单个目录(包括子目录)下的所有cpp源文件
为了达到引入目录下的所有源文件,包括子目录这个目标,我在android.mk
中这样写
#声明一个变量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源文件
这里,我直接给出代码
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日修正):
# 扫描目录下的所有源文件
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
文件中变量的值,就可以观察分析问题所在了,使用代码
$(warning $(LOCAL_SRC_FILES))
就可以在编译过程中从终端窗口中观察到变量LOCAL_SRC_FILES
的值