Android.mk 文件的编写
常用Android.mk文件生成动态库,可执行二进制,在Android framework开发中还会使用它生成jar包及apk
生成二进制文件 helloWorld实例
使用tree
命令查看一下当前的目录结构
$ tree
.
├── jni
│ ├── Android.mk
│ ├── Application.mk
│ └── src
│ ├──helloWorld.c
Android.mk文件如下
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_SRC_FILES := src/helloworld.c
LOCAL_MODULE := helloworld
#LOCAL_C_INCLUDES :=
#LOCAL_STATIC_LIBRARIES :=
#LOCAL_SHARED_LIBRARIES :=
include $(BUILD_EXECUTABLE)
其中最后一行的BUILD_EXECUTABLE
表示编译出来的是一个可执行二进制,如果想要生成动态库可以使用BUILD_SHARED_LIBRARY
,静态库使用BUILD_STATIC_LIBRARY
在编译过程中如果出现了奇怪的现象可以是用vim中的set list
查看文件是否包含windows系统上的符号,或者不该有的空格符
vim 的非可见字符(listchars)
-显示和隐藏
默认情况下vim是不显示space,tabs,newlines,trailing space,wrapped lines
等不可见字符的。但是我们可以使用list
选项来显示这些字符,例如:
:set list
1 LOCAL_PATH := $(call my-dir)$
2 $
3 $
4 $
5 $
6 include $(CLEAR_VARS)$
7 $
8 LOCAL_THIRD_LDLIBS_PATH = src/third_party_libs/lib$
9 $
10 LOCAL_MODULE := libavfilter$
也可以使用nolist
来隐藏不可见字符
:set nolist
1 LOCAL_PATH := $(call my-dir)
2
3
4
5
6 include $(CLEAR_VARS)
7
8 LOCAL_THIRD_LDLIBS_PATH = src/third_party_libs/lib
9
10 LOCAL_MODULE := libavfilter
11 LOCAL_C_INCLUDES := src/third_party_libs/include
12 LOCAL_SRC_FILES := $(LOCAL_THIRD_LDLIBS_PATH)/libavfilter.so
13 include $(PREBUILT_SHARED_LIBRARY)
在mk文件中执行shell命令
下面是打印当前路径的操作
文件内容如下:
1 LOCAL_PATH := $(call my-dir)
2
3
4 define echo-path #定义一个echo-path的函数
5 $(shell echo $(LOCAL_PATH))
6 endef #结束定义
7 ECHO_PATH = $(call echo-path) #执行函数并将结果输出到变量ECHO_PATH中
8 $(warning $(ECHO_PATH)) #显示变量ECHO_PATH
9
10 include $(CLEAR_VARS)
添加预编译库
如果项目中包含一些与编译库可以使用PREBUILT_STATIC_LIBRARY
或者PREBUILT_SHARED_LIBRARY
变量控制代码如下:
如果是静态库
10 include $(CLEAR_VARS)
11
12
13 LOCAL_THIRD_LDLIBS_PATH = src/third_party_libs/lib
14
15 LOCAL_MODULE := avfilter
16 LOCAL_C_INCLUDES := src/third_party_libs/include
17 LOCAL_SRC_FILES := $(LOCAL_THIRD_LDLIBS_PATH)/libavfilter.a
18 include $(PREBUILT_STATIC_LIBRARY)
如果是动态库
10 include $(CLEAR_VARS)
11
12
13 LOCAL_THIRD_LDLIBS_PATH = src/third_party_libs/lib
14
15 LOCAL_MODULE := avfilter
16 LOCAL_C_INCLUDES := src/third_party_libs/include
17 LOCAL_SRC_FILES := $(LOCAL_THIRD_LDLIBS_PATH)/libavfilter.so
18 include $(PREBUILT_SHARED_LIBRARY)
调用者的使用
调用者要是用LOCAL_STATIC_LIBRARIES
或者LOCAL_SHARED_LIBRARIES
来包含这些模块
例如:
静态库
LOCAL_STATIC_LIBRARIES := avfilter
动态库
LOCAL_SHARED_LIBRARIES := avfilter
完整代码
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_THIRD_LDLIBS_PATH = src/third_party_libs/lib
LOCAL_MODULE := avfilter
LOCAL_C_INCLUDES := src/third_party_libs/include
LOCAL_SRC_FILES := $(LOCAL_THIRD_LDLIBS_PATH)/libavfilter.a
include $(PREBUILT_STATIC_LIBRARY)
include $(CLEAR_VARS)
LOCAL_SRC_FILES := src/helloworld.c
LOCAL_MODULE := helloworld
#LOCAL_C_INCLUDES :=
LOCAL_STATIC_LIBRARIES := avfilter
#LOCAL_SHARED_LIBRARIES :=
LOCAL_LDLIBS += -lm -lz -lc
include $(BUILD_SHARED_LIBRARY)
有时第三方库需要依赖一些基础数学库等,这时可以通过LOCAL_LDLIBS
来指定
为项目指定API级别及c++的支持
在Android.mk
文件中,指定API级别可是用TARGET_PLATFORM
变量
TARGET_PLATFORM := android-19
通常会在Application.mk
文件中设置一下属性
在Application.mk
文件中,指定API级别可是用APP_PLATFORM
变量
APP_PLATFORM := android-19
指定目标平台使用APP_ABI
变量
APP_ABI := armeabi-v7a
指定C++运行时,使用APP_STL
。通常使用静态的运行时库
APP_STL := gnustl_static
指定编译器版本,使用NDK_TOOLCHAIN_VERSION
变量
将此变量定义为 4.9 或 4.8 以选择 GCC 编译器的版本。 64 位 ABI 默认使用版本 4.9 ,32 位 ABI 默认使用版本 4.8。要选择 Clang 的版本,请将此变量定义为 clang3.4、clang3.5 或 clang。 指定 clang 会选择 Clang 的最新版本。
NDK_TOOLCHAIN_VERSION := 4.9
以下是Application.mk
书写实例:
1 APP_ABI := armeabi-v7a
2 NDK_TOOLCHAIN_VERSION := 4.9
3 APP_STL := gnustl_static
4 APP_PLATFORM := android-16
如果要包含c++的支持需要包含相应的头文件,及指定c++支持
可以在Android.mk
文件中添加如下变量
通过变量LOCAL_CPPFLAGS
来指定c++的标志位
如果是c++11标志可赋值-std=gnu++11
,例如:
LOCAL_CPPFLAGS := -std=gnu++11 -fvisibility=protected
通过变量LOCAL_CFLAGS
指定编译过程的宏变量和标志位,例如:
LOCAL_CFLAGS := -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__linux__ -DTHREAD_SAFETY -DBUILD_JNI
在任意目录执行NDK编译
可以使用如下命令:
ndk-build NDK_PROJECT_PATH=. APP_BUILD_SCRIPT=./Android.mk
利用NDK_PROJECT_PATH
指定工程目录,APP_BUILD_SCRIPT
指定Android.mk
文件所在目录