NDK使用静态库模块组织代码详解

http://blog.csdn.net/n5/article/details/23942369

使用NDK时，需要编写Android.mk文件，在里面指定要编译的c/c++源码，如果源码比较多，则最好分成模块。

NDK build系统可以编译静态库和动态库，一般把各个模块都编译为静态库，最终的项目编译为动态库并依赖所有的静态库。

本文总结一下实现的基本方法和步骤。首先需要设定一个例子项目作为参考，例子项目的目录结构为：

[html]  view plain copy

1. example  
2.   - foo  
3.        -src  
4.              -subdirFoo  
5.              -subdirBar  
6.        -android  
7.              -Android.mk  
8.   - other  
9.        -src  
10.        -android  
11.              -Android.mk  
12.   - other2  
13.        -src  
14.        -android  
15.              -Android.mk  
16.   - app  
17.        -src  
18.        -prj.android  
19.              -build_native.sh  
20.              -jni  
21.                  -Android.mk  

foo, other, other2为三个静态库模块，其src目录中包含c++源码和头文件；

app为应用项目目录，src中为c++源码和头文件，prj.android为android工程目录（eclipse项目目录），jni为Android jni目录。

foo库依赖于other和other2库，app则依赖foo,other,other2。

下面为实现的详细步骤：

1）给想编译成静态库的模块写一个单独的Android.mk文件，例如foo模块的是：

[plain]  view plain copy

1. LOCAL_PATH := $(call my-dir)  
2. include $(CLEAR_VARS)  
3.   
4. LOCAL_MODULE    := foo_static   #模块名,其他模块使用该名字引用此模块  
5.   
6. LOCAL_MODULE_FILENAME := libfoo #模块文件名，可选，如果不写则使用模块名（前缀lib),如果写了且无lib前缀则会添加lib前缀  
7.   
8. MY_SRC_BASE_PATH := ../src/   #该路径是相对于此Android.mk文件所在位置的  #NDK文档建议自己起的定义名字用MY开头，其实只要不使用LOCAL等系统占用的名字就行  
9.   
10. MY_SRC_FILES := \  
11.     $(MY_SRC_BASE_PATH)/foo.c \  
12.     $(MY_SRC_BASE_PATH)/foo.cpp \    #c++源文件后缀默认为cpp，也可以通过参数设定后缀，具体参考NDK文档  
13.     $(MY_SRC_BASE_PATH)/bar.cpp  
14.   
15. LOCAL_SRC_FILES := $(MY_SRC_FILES)   #设定源文件列表给LOCAL变量  
16.   
17. MY_C_INCLUDES := \                      #头文件搜索路径  
18.     $(LOCAL_PATH)/$(MY_SRC_BASE_PATH) \  
19.     $(LOCAL_PATH)/$(MY_SRC_BASE_PATH)/subdirFoo \  
20.     $(LOCAL_PATH)/$(MY_SRC_BASE_PATH)/subdirBar  
21.            
22. LOCAL_EXPORT_C_INCLUDES := $(MY_C_INCLUDES) #设定export头文件路径，这是为了让其他模块可以搜索到此模块的头文件。export路径可以和此模块使用的路径不一样，这里简单处理为使用相同的路径搜索列表  
23.             
24.             
25. LOCAL_C_INCLUDES := $(MY_C_INCLUDES) #设置此模块使用的头文件路径搜索列表  
26.   
27.   
28. LOCAL_CFLAGS += -Wno-psabi          #这儿加入必要的编译选项  
29. LOCAL_EXPORT_CFLAGS += -Wno-psabi   #这个也是为了给其他模块使用，这样连接该模块的其他模块也会带上这里的选项  
30.   
31. LOCAL_WHOLE_STATIC_LIBRARIES := other_static other2_static #依赖的其他静态库,用空格分离;这儿填写的是静态库的mk中的LOCAL_MODULE设定的名字  
32.   
33.   
34. include $(BUILD_STATIC_LIBRARY) #编译为静态库  
35.   
36. #导入所依赖的模块，这里填写的是所依赖模块的Android.mk文件所在的路径#这个路径是相对于NDK_MODULE_PATH的，注意NDK_MODULE_PATH不是mk文件里面定义的常量，而是系统路径中的，但也可以在ndk-build命令行中指定  
37. $(call import-module,other/android) \   
38. $(call import-module,other2/android)  

other和other2的mk文件类似，只是他们不依赖于其他模块就不需要连接相应的库了

2) 实现app的Android.mk:

[html]  view plain copy

1. LOCAL_PATH := $(call my-dir)  
2.   
3. include $(CLEAR_VARS)  
4.   
5. LOCAL_MODULE := app_shared  
6.   
7. LOCAL_MODULE_FILENAME := libapp  
8.   
9. APP_SRC_PATH := ../../src  
10.   
11. APP_SRC_FILES := \  
12.     $(APP_SRC_PATH)/app.cpp \  
13.     $(APP_SRC_PATH)/test.c  
14.       
15.   
16. LOCAL_SRC_FILES := $(APP_SRC_FILES)  
17.                      
18. LOCAL_C_INCLUDES := \         #指定头文件搜索路径（静态库模块中的头文件搜索路径由模块自己导出，见上面的LOCAL_EXPORT_C_INCLUDES)  
19.     $(LOCAL_PATH)/$(APP_SRC_PATH) \  
20.     $(LOCAL_PATH)/$(APP_SRC_PATH)/sub1 \  
21.     $(LOCAL_PATH)/$(APP_SRC_PATH)/sub2  
22.   
23. #由于这是最终的app的模块，不会被其他模块使用，所以不需要导出自己的头文件搜索路径  
24.      
25. LOCAL_CFLAGS := \                #添加项目使用的编译选项  
26.     -DAPP_PLATFORM_ANDROID \  
27.     -DDEBUG  
28.       
29.      
30. LOCAL_WHOLE_STATIC_LIBRARIES := foo_static other_static other2_static #依赖静态库,用空格分离;这儿填写的是静态库的mk中的LOCAL_MODULE设定的名字  
31.               
32. include $(BUILD_SHARED_LIBRARY) #编译为动态链接库: .so文件  
33.   
34. #导入所依赖的模块，这里填写的是所依赖模块的Android.mk文件所在的路径  
35. #这个路径是相对于NDK_MODULE_PATH的，注意NDK_MODULE_PATH不是mk文件里面定义的常量，而是系统路径中的，但也可以在ndk-build命令行中指定  
36. $(call import-module,foo/android) \  
37. $(call import-module,other/android) \   
38. $(call import-module,other2/android)  

3）现在已经基本ok了，但是我们还要指定一下模块的搜索路径，可通过在系统路径搜索中添加NDK_MODULE_PATH实现，也可以在ndk-build命令行中指定，我推荐使用后者。以下是编译脚本build_native.sh中相关的部分：

[html]  view plain copy

1. #确定设置了NDK_ROOTif [ -z "${NDK_ROOT+aaa}" ];then  
2. echo "please define NDK_ROOT"  
3. exit 1  
4. fi  
5. DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"  
6. # ... use paths relative to current directory  
7.   
8. PRJ_ROOT="$DIR/../../"  #项目根目录，即example目录  
9. APP_ANDROID_ROOT="$DIR" #Android工程目录，即prj.android目录  
10.   
11.   
12. "$NDK_ROOT"/ndk-build -j4 -C "$APP_ANDROID_ROOT" $* \  
13.        "NDK_MODULE_PATH=${PRJ_ROOT}"  
14.   
15. #NDK_MODULE_PATH设置为项目跟目录，这样import-module设置的路径就相对于根目录了，如foo/android