NDK使用静态库模块组织代码详解
2015-04-12 17:07
357 查看
使用NDK时,需要编写Android.mk文件,在里面指定要编译的c/c++源码,如果源码比较多,则最好分成模块。
NDK build系统可以编译静态库和动态库,一般把各个模块都编译为静态库,最终的项目编译为动态库并依赖所有的静态库。
本文总结一下实现的基本方法和步骤。首先需要设定一个例子项目作为参考,例子项目的目录结构为:
[html] view
plaincopy
example
- foo
-src
-subdirFoo
-subdirBar
-android
-Android.mk
- other
-src
-android
-Android.mk
- other2
-src
-android
-Android.mk
- app
-src
-prj.android
-build_native.sh
-jni
-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
plaincopy
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := foo_static #模块名,其他模块使用该名字引用此模块
LOCAL_MODULE_FILENAME := libfoo #模块文件名,可选,如果不写则使用模块名(前缀lib),如果写了且无lib前缀则会添加lib前缀
MY_SRC_BASE_PATH := ../src/ #该路径是相对于此Android.mk文件所在位置的 #NDK文档建议自己起的定义名字用MY开头,其实只要不使用LOCAL等系统占用的名字就行
MY_SRC_FILES := \
$(MY_SRC_BASE_PATH)/foo.c \
$(MY_SRC_BASE_PATH)/foo.cpp \ #c++源文件后缀默认为cpp,也可以通过参数设定后缀,具体参考NDK文档
$(MY_SRC_BASE_PATH)/bar.cpp
LOCAL_SRC_FILES := $(MY_SRC_FILES) #设定源文件列表给LOCAL变量
MY_C_INCLUDES := \ #头文件搜索路径
$(LOCAL_PATH)/$(MY_SRC_BASE_PATH) \
$(LOCAL_PATH)/$(MY_SRC_BASE_PATH)/subdirFoo \
$(LOCAL_PATH)/$(MY_SRC_BASE_PATH)/subdirBar
LOCAL_EXPORT_C_INCLUDES := $(MY_C_INCLUDES) #设定export头文件路径,这是为了让其他模块可以搜索到此模块的头文件。export路径可以和此模块使用的路径不一样,这里简单处理为使用相同的路径搜索列表
LOCAL_C_INCLUDES := $(MY_C_INCLUDES) #设置此模块使用的头文件路径搜索列表
LOCAL_CFLAGS += -Wno-psabi #这儿加入必要的编译选项
LOCAL_EXPORT_CFLAGS += -Wno-psabi #这个也是为了给其他模块使用,这样连接该模块的其他模块也会带上这里的选项
LOCAL_WHOLE_STATIC_LIBRARIES := other_static other2_static #依赖的其他静态库,用空格分离;这儿填写的是静态库的mk中的LOCAL_MODULE设定的名字
include $(BUILD_STATIC_LIBRARY) #编译为静态库
#导入所依赖的模块,这里填写的是所依赖模块的Android.mk文件所在的路径#这个路径是相对于NDK_MODULE_PATH的,注意NDK_MODULE_PATH不是mk文件里面定义的常量,而是系统路径中的,但也可以在ndk-build命令行中指定
$(call import-module,other/android) \
$(call import-module,other2/android)
other和other2的mk文件类似,只是他们不依赖于其他模块就不需要连接相应的库了
2) 实现app的Android.mk:
[html] view
plaincopy
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := app_shared
LOCAL_MODULE_FILENAME := libapp
APP_SRC_PATH := ../../src
APP_SRC_FILES := \
$(APP_SRC_PATH)/app.cpp \
$(APP_SRC_PATH)/test.c
LOCAL_SRC_FILES := $(APP_SRC_FILES)
LOCAL_C_INCLUDES := \ #指定头文件搜索路径(静态库模块中的头文件搜索路径由模块自己导出,见上面的LOCAL_EXPORT_C_INCLUDES)
$(LOCAL_PATH)/$(APP_SRC_PATH) \
$(LOCAL_PATH)/$(APP_SRC_PATH)/sub1 \
$(LOCAL_PATH)/$(APP_SRC_PATH)/sub2
#由于这是最终的app的模块,不会被其他模块使用,所以不需要导出自己的头文件搜索路径
LOCAL_CFLAGS := \ #添加项目使用的编译选项
-DAPP_PLATFORM_ANDROID \
-DDEBUG
LOCAL_WHOLE_STATIC_LIBRARIES := foo_static other_static other2_static #依赖静态库,用空格分离;这儿填写的是静态库的mk中的LOCAL_MODULE设定的名字
include $(BUILD_SHARED_LIBRARY) #编译为动态链接库: .so文件
#导入所依赖的模块,这里填写的是所依赖模块的Android.mk文件所在的路径
#这个路径是相对于NDK_MODULE_PATH的,注意NDK_MODULE_PATH不是mk文件里面定义的常量,而是系统路径中的,但也可以在ndk-build命令行中指定
$(call import-module,foo/android) \
$(call import-module,other/android) \
$(call import-module,other2/android)
3)现在已经基本ok了,但是我们还要指定一下模块的搜索路径,可通过在系统路径搜索中添加NDK_MODULE_PATH实现,也可以在ndk-build命令行中指定,我推荐使用后者。以下是编译脚本build_native.sh中相关的部分:
[html] view
plaincopy
#确定设置了NDK_ROOTif [ -z "${NDK_ROOT+aaa}" ];then
echo "please define NDK_ROOT"
exit 1
fi
DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
# ... use paths relative to current directory
PRJ_ROOT="$DIR/../../" #项目根目录,即example目录
APP_ANDROID_ROOT="$DIR" #Android工程目录,即prj.android目录
"$NDK_ROOT"/ndk-build -j4 -C "$APP_ANDROID_ROOT" $* \
"NDK_MODULE_PATH=${PRJ_ROOT}"
#NDK_MODULE_PATH设置为项目跟目录,这样import-module设置的路径就相对于根目录了,如foo/android
NDK build系统可以编译静态库和动态库,一般把各个模块都编译为静态库,最终的项目编译为动态库并依赖所有的静态库。
本文总结一下实现的基本方法和步骤。首先需要设定一个例子项目作为参考,例子项目的目录结构为:
[html] view
plaincopy
example
- foo
-src
-subdirFoo
-subdirBar
-android
-Android.mk
- other
-src
-android
-Android.mk
- other2
-src
-android
-Android.mk
- app
-src
-prj.android
-build_native.sh
-jni
-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
plaincopy
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := foo_static #模块名,其他模块使用该名字引用此模块
LOCAL_MODULE_FILENAME := libfoo #模块文件名,可选,如果不写则使用模块名(前缀lib),如果写了且无lib前缀则会添加lib前缀
MY_SRC_BASE_PATH := ../src/ #该路径是相对于此Android.mk文件所在位置的 #NDK文档建议自己起的定义名字用MY开头,其实只要不使用LOCAL等系统占用的名字就行
MY_SRC_FILES := \
$(MY_SRC_BASE_PATH)/foo.c \
$(MY_SRC_BASE_PATH)/foo.cpp \ #c++源文件后缀默认为cpp,也可以通过参数设定后缀,具体参考NDK文档
$(MY_SRC_BASE_PATH)/bar.cpp
LOCAL_SRC_FILES := $(MY_SRC_FILES) #设定源文件列表给LOCAL变量
MY_C_INCLUDES := \ #头文件搜索路径
$(LOCAL_PATH)/$(MY_SRC_BASE_PATH) \
$(LOCAL_PATH)/$(MY_SRC_BASE_PATH)/subdirFoo \
$(LOCAL_PATH)/$(MY_SRC_BASE_PATH)/subdirBar
LOCAL_EXPORT_C_INCLUDES := $(MY_C_INCLUDES) #设定export头文件路径,这是为了让其他模块可以搜索到此模块的头文件。export路径可以和此模块使用的路径不一样,这里简单处理为使用相同的路径搜索列表
LOCAL_C_INCLUDES := $(MY_C_INCLUDES) #设置此模块使用的头文件路径搜索列表
LOCAL_CFLAGS += -Wno-psabi #这儿加入必要的编译选项
LOCAL_EXPORT_CFLAGS += -Wno-psabi #这个也是为了给其他模块使用,这样连接该模块的其他模块也会带上这里的选项
LOCAL_WHOLE_STATIC_LIBRARIES := other_static other2_static #依赖的其他静态库,用空格分离;这儿填写的是静态库的mk中的LOCAL_MODULE设定的名字
include $(BUILD_STATIC_LIBRARY) #编译为静态库
#导入所依赖的模块,这里填写的是所依赖模块的Android.mk文件所在的路径#这个路径是相对于NDK_MODULE_PATH的,注意NDK_MODULE_PATH不是mk文件里面定义的常量,而是系统路径中的,但也可以在ndk-build命令行中指定
$(call import-module,other/android) \
$(call import-module,other2/android)
other和other2的mk文件类似,只是他们不依赖于其他模块就不需要连接相应的库了
2) 实现app的Android.mk:
[html] view
plaincopy
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := app_shared
LOCAL_MODULE_FILENAME := libapp
APP_SRC_PATH := ../../src
APP_SRC_FILES := \
$(APP_SRC_PATH)/app.cpp \
$(APP_SRC_PATH)/test.c
LOCAL_SRC_FILES := $(APP_SRC_FILES)
LOCAL_C_INCLUDES := \ #指定头文件搜索路径(静态库模块中的头文件搜索路径由模块自己导出,见上面的LOCAL_EXPORT_C_INCLUDES)
$(LOCAL_PATH)/$(APP_SRC_PATH) \
$(LOCAL_PATH)/$(APP_SRC_PATH)/sub1 \
$(LOCAL_PATH)/$(APP_SRC_PATH)/sub2
#由于这是最终的app的模块,不会被其他模块使用,所以不需要导出自己的头文件搜索路径
LOCAL_CFLAGS := \ #添加项目使用的编译选项
-DAPP_PLATFORM_ANDROID \
-DDEBUG
LOCAL_WHOLE_STATIC_LIBRARIES := foo_static other_static other2_static #依赖静态库,用空格分离;这儿填写的是静态库的mk中的LOCAL_MODULE设定的名字
include $(BUILD_SHARED_LIBRARY) #编译为动态链接库: .so文件
#导入所依赖的模块,这里填写的是所依赖模块的Android.mk文件所在的路径
#这个路径是相对于NDK_MODULE_PATH的,注意NDK_MODULE_PATH不是mk文件里面定义的常量,而是系统路径中的,但也可以在ndk-build命令行中指定
$(call import-module,foo/android) \
$(call import-module,other/android) \
$(call import-module,other2/android)
3)现在已经基本ok了,但是我们还要指定一下模块的搜索路径,可通过在系统路径搜索中添加NDK_MODULE_PATH实现,也可以在ndk-build命令行中指定,我推荐使用后者。以下是编译脚本build_native.sh中相关的部分:
[html] view
plaincopy
#确定设置了NDK_ROOTif [ -z "${NDK_ROOT+aaa}" ];then
echo "please define NDK_ROOT"
exit 1
fi
DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
# ... use paths relative to current directory
PRJ_ROOT="$DIR/../../" #项目根目录,即example目录
APP_ANDROID_ROOT="$DIR" #Android工程目录,即prj.android目录
"$NDK_ROOT"/ndk-build -j4 -C "$APP_ANDROID_ROOT" $* \
"NDK_MODULE_PATH=${PRJ_ROOT}"
#NDK_MODULE_PATH设置为项目跟目录,这样import-module设置的路径就相对于根目录了,如foo/android
相关文章推荐
- NDK使用静态库模块组织代码详解
- NDK使用静态库模块组织代码详解
- AngularJS —— 使用模块组织你的代码 【已翻译100%】(1/3)
- 生成动态库so的方法|解决NDK r5b引用静态库失效的问题|在NDK的Nactive代码中使用Android Log的方法|生成Native java头文件
- NDK 编译和使用静态库、动态库; Android.mk 文件语法详解; Android.mk高级写法
- C# DllImport 系统调用使用详解 托管代码的介绍 EntryPoint的使用
- 【转帖】C# DllImport 系统调用使用详解 托管代码的介绍 EntryPoint的使用
- 用VC写Assembly代码(6)--附录3[X86指令使用详解]
- Struts实例详解6-- Struts的模块使用实例
- 技巧:Linux 动态库与静态库制作及使用详解
- CListCtrl用法 CListCtrl使用详解 (代码)
- .Net开发必备十大工具详解之使用GhostDoc为代码生成注释文档
- 使用org.apache.lucene创建和查询索引核心代码详解
- php中使用parse_url()对网址进行解析的实现代码(parse_url详解)
- java开发环境eclipse的使用(模块代码折叠、可视化开发插件、生成Jar插件)
- 在NDK的Nactive代码中使用Android Log的方法
- php中使用parse_url()对网址进行解析的实现代码(parse_url详解)
- 《代码大全》读书笔记--组织直线型代码、使用条件语句
- [经验总结]Perl模块使用 => 简短例子代码集合
- Ruby Benchmark 模块提供了测量和报告Ruby代码运行使用时间的方法。