菜鸟级别解释::=是赋值的意思,$是引用某变量的值,include是执行动作。GNU:(GNU's Not Unix),GNU计划,为保证GNU软件可以自由地“使用、复制、修改和发布”,GNU通用公共许可证(GNU General Public License,GPL)。即“反版权”(或称Copyleft)概念。
一个Android.mk file用来向编译系统描述你的源代码。具体来说:-该文件是GNU Makefile的一小部分。这个文件的语法允许把你的源代码组织成模块:静态库.a和共享库.so。你可以在每一个Android.mk file中定义一个或多个模块。下面是常用语句的解释:
*LOCAL_PATH:= $(call my-dir):首先必须定义好LOCAL_PATH变量。它用于在开发树中查找源文件。宏函数’my-dir’,由编译系统提供,用于返回当前路径(即包含Android.mk file文件的目录)。
*include $( CLEAR_VARS):CLEAR_VARS由编译系统提供,指定让GNU MAKEFILE为你清除许多LOCAL_XXX变量,除LOCAL_PATH
*LOCAL_MODULE := helloworld:LOCAL_MODULE变量必须定义,以标识你在Android.mk文件中描述的每个模块。名称必须是唯一的,而且不包含任何空格。注意编译系统会自动产生合适的前缀和后缀,换句话说,一个被命名为'foo'的共享库模块,将会生成'libfoo.so'文件。重要注意事项:如果你把库命名为‘libhelloworld’,编译系统将不会添加任何的lib前缀,也会生成libhelloworld.so,这是为了支持来源于Android平台的源代码的Android.mk文件,如果你确实需要这么做的话。
*LOCAL_SRC_FILES := helloworld.c:变量必须包含将要编译打包进模块中的C或C++源代码文件。注意,你不用在这里列出头文件和包含文件,因为编译系统将会自动为你找出依赖型的文件;仅仅列出直接传递给编译器的源代码文件就好.
*include $(BUILD_SHARED_LIBRARY):BUILD_SHARED_LIBRARY是编译系统提供的变量,指向一个GNU Makefile脚本,负责收集自从上次调用'include $(CLEAR_VARS)'以来,定义在LOCAL_XXX变量中的所有信息,并且决定编译什么,如何正确地去做。并根据其规则生成共享库
make文件变量:GNU Make变量:在你的Android.mk文件解析之前,就由编译系统定义好了;自己定义的变量:为了方便在Android.mk中定义自己的变量,我们建议使用MY_前缀
Android.mk使用模板
在一个Android.mk中可以生成多个可执行程序、动态库和静态库。
编译应用程序:
- #Test Exe
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- LOCAL_SRC_FILES:= main.c
- LOCAL_MODULE:= test_exe
- #LOCAL_C_INCLUDES := //加入所需要包含的头文件路径
- #LOCAL_STATIC_LIBRARIES := //加入所需要链接的静态库(*.a)的名称,库在系统的lib目录下
- #LOCAL_SHARED_LIBRARIES := //加入所需要链接的动态库(*.so)的名称
- include $(BUILD_EXECUTABLE) //表示以一个可执行程序的方式进行编译
编译静态库的模板:
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- LOCAL_SRC_FILES:= main.c
- LOCAL_MODULE:= test_exe
- #LOCAL_C_INCLUDES := //加入所需要包含的头文件路径
- #LOCAL_STATIC_LIBRARIES := //加入所需要链接的静态库(*.a)的名称,库在系统的lib目录下
- #LOCAL_SHARED_LIBRARIES := //加入所需要链接的动态库(*.so)的名称
- include $(BUILD_STATIC_LIBRARY) //表示以静态库的方式进行编译
- <span style="color:#993300;">包含的头文件路径特别说明:</span>
- LOCAL_C_INCLUDES:=android/ftplib
- LOCAL_C_INCLUDES+=android
- LOCAL_C_INCLUDES+=android/adapi
- android、android/ftplib、android/ftplib:其中的android是在工程根目录下的文件夹
编译动态库模版:
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- LOCAL_MODULE:= helloworld
- LOCAL_SRC_FILES := helloworld.c
- include $(BUILD_SHARED_LIBRARY)
编译两个动态库模块:
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- #清除一些变量
- LOCAL_MODULE := test
- #要生成的库名
- LOCAL_SRC_FILES := testso.cpp
- #库对应的源文件
- include $(BUILD_SHARED_LIBRARY)
- include $(CLEAR_VARS)
- #清除一些变量
- LOCAL_MODULE := WsJniPlayer
- #定义另外一个库的名
- LOCAL_SRC_FILES := WsJniPlayer.cpp
- #定义库对应的源文件
- LOCAL_LDLIBS := -ldl -llog
- #编译你的模块要使用的附加的链接器选项
- include $(BUILD_SHARED_LIBRARY)
编译两个动态库,其中一个是第三方库:
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- LOCAL_MODULE := libtest
- LOCAL_SRC_FILES := libtest.so
- include $(PREBUILT_SHARED_LIBRARY)
- include $(CLEAR_VARS)
- #清除一些变量
- LOCAL_SRC_FILES := WsJniTest.cpp
- #定义库对应的源文件
- LOCAL_MODULE := WsJniTest
- #定义另外一个库的名
- LOCAL_LDLIBS := -ldl -llog//运行时需要动态加载库
- include $(BUILD_SHARED_LIBRARY)
隐式调用第三方库
- LOCAL_PATH := $(call my-dir)
- include $(CLEAR_VARS)
- LOCAL_SRC_FILES := test.cpp
- LOCAL_PRELINK_MODULE := false
- LOCAL_MODULE := libtest
- LOCAL_MODULE_TAGS := optional
- include $(BUILD_SHARED_LIBRARY)
- include $(CLEAR_VARS)
- LOCAL_SRC_FILES := WsJniPlayer.cpp
- LOCAL_CFLAGS := -ltest
- LOCAL_LDFLAGS := -L$(LOCAL_PATH)//要隐式调用库的位置
- LOCAL_SHARED_LIBRARIES :=libtest//要隐式调用库的名称
- LOCAL_MODULE := WsJniPlayer
- LOCAL_MODULE_TAGS := optional
- include $(BUILD_SHARED_LIBRARY)
LOCAL_SHARED_LIBRARIES和LOCAL_LDLIBS区别:
LOCAL_LDLIBS:链接的库不产生依赖关系,一般用于不需要重新编译的库,如库不存在,则会报错找不到。且貌似只能链接那些存在于系统目录下本模块需要连接的库。
LOCAL_SHARED_LIBRARIES :会生成依赖关系,当库不存在时会去编译这个库。例如:开发中出现过这种情况,会编译出一个错误的库
3、cpp文件说明
自动生成的cpp文件是C++源代码文件,这个默认的文件是空的,只包含两include语句:#include <string>和#include <jni.h>
jni.h文件,定义了本地的数据类型,本地数据类型对应java类型前加上一个j,如int--->jint、jstring-->java.lang.String。本地数据类型是介于java类型和C++类型的中间类型,jni就是java和C++调用的桥。
特别需要注意的JNI调用的两点规则:
a、java程序只能调用C语言接口,因此接口前要加上:extern "C"关键字。这是因为NDK主要是配合C语言开发,但是Sequoyah插件帮我们生成的是cpp文件。在默认情况下,会使用C++的编译方式来进行编译,这样导致java调用时无法找到对应的接口函数。C和C++编译时,可能函数名不一样,也即:JAVA调用C编译类型的函数名。
b、函数定义规则:在编写函数时,函数名必须符合规则,不然JNI调用时无法找到需要的函数。
4、添加依赖包
代码编写后,可能发现报错,提示找不到于与JNI相关的一些定义,这就需要添加NDK依赖包:项目右键-》properties->C/C++Gerneral->paths and symbols->includes->GNU C->add->file system,添加<ndk根目录>\platforms\android-8\arch-arm\usr\include,添加完成后,重新build项目,即可解决。