下面分别做介绍:
cmake_minimum_required(VERSION 3.4.1)用来设置在编译本地库时我们需要的最小的cmake版本,AndroidStudio自动生成,我们几乎不需要自己管。
add_library( # Sets the nameof thelibrary. native-lib # Sets thelibrary as asharedlibrary.SHARED # Provides a relative pathto your sourcefile(s).
src/main/cpp/native-lib.cpp )
add_library用来设置编译生成的本地库的名字为native-lib,SHARED表示编译生成的是动态链接库(这个概念前面已经提到过了),src/main/cpp/native-lib.cpp表示参与编译的文件的路径,这里面可以写多个文件的路径。
find_library是用来添加一些我们在编译我们的本地库的时候需要依赖的一些库,由于cmake已经知道系统库的路径,所以我们这里只是指定使用log库,然后给log库起别名为log-lib便于我们后面引用,此处的log库是我们后面调试时需要用来打log日志的库,是NDK为我们提供的。
target_link_libraries是为了关联我们自己的库和一些第三方库或者系统库,这里把我们把自己的库native-lib库和log库关联起来。
NDK自定义配置
1 . 添加多个参与编译的C/C++文件
首先,我们发现我们上面的例子都是涉及到一个C++文件,那么我们实际的项目不可能只有一个C++文件,所以我们首先要改变CMakeLists.txt文件,如下 :
add_library( HelloNDK SHARED src/main/cpp/HelloNDK.c src/main/cpp/HelloJNI.c)
简单吧,简单明了,但是这里要注意的是,你在写路径的时候一定要注意当前的CMakeLists.txt在项目中的位置,上面的路径是相对于CMakeLists.txt写的。
2 . 我们想编译出多个so库
大家会发现,我们上面这样写,由于只有一个CMakeLists.txt文件,所以我们会把所有的C/C++文件编译成一个so库,这是很不合适的,这里我们就试着学学怎么编译出多个so库。
先放上我的项目文件夹结构图:
然后看看我们每个CMakeLists.txt文件是怎么写的:
one文件夹内的CMakeLists.txt文件的内容:
ADD_LIBRARY(one-lib SHAREDone-lib.c)target_link_libraries(one-liblog)
two文件夹内的CMakeLists.txt文件的内容:
ADD_LIBRARY(two-lib SHAREDtwo-lib.c)target_link_libraries(two-liblog)
app目录下的CMakeLists.txt文件的内容
# Sets the minimum version of CMake required to build the native library.cmake_minimum_required(VERSION3.4.1)add_library( HelloNDK SHARED src/main/cpp/HelloNDK.c src/main/cpp/HelloJNI.c)find_library(# Sets the name of the path variable. log-lib# Specifies the name of the NDK library that# you want CMake to locate. log )target_link_libraries(HelloNDK log)ADD_SUBDIRECTORY(src/main/cpp/one)ADD_SUBDIRECTORY(src/main/cpp/two)
通过以上的配置我们可以看出CMakeLists.txt文件的配置是支持继承的,所以我们在子配置文件中只是写了不同的特殊配置项的配置,最后在最上层的文件中配置子配置文件的路径即可,现在编译项目,我们会在<项目目录>\app\build\intermediates\cmake\debug\obj\armeabi下面就可以看到生成的动态链接库。而且是三个动态链接库
3 . 更改动态链接库生成的目录
我们是不是发现上面的so库的路径太深了,不好找,没事,可以配置,我们只需要在顶层的CMakeLists.txt文件中加入下面这句就可以了
#设置生成的so动态库最后输出的路径set(CMAKE_LIBRARY_OUTPUT_DIRECTORY${PROJECT_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI})
然后我们就可以在app/src/main下看到jniLibs目录,在其中看到我们的动态链接库的文件夹和文件(这里直接配置到了系统默认的路径,如果配置到其他路径需要在gradle文件中使用jinLibs.srcDirs = ['newDir']进行指定)。
NDK错误调试
在开发的过程中,难免会遇到bug,那怎么办,打log啊,下面我们就谈谈打log和看log的姿势。
1 . 在C/C++文件中打log
(1) 在C/C++文件中添加头文件
#include
1
上面是打印日志的头文件,必须添加
(2) 添加打印日志的宏定义和TAG
//log定义#defineLOG"JNILOG"// 这个是自定义的LOG的TAG#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG,LOG,__VA_ARGS__)// 定义LOGD类型#define LOGI(...) __android_log_print(ANDROID_LOG_INFO,LOG,__VA_ARGS__)// 定义LOGI类型#define LOGW(...) __android_log_print(ANDROID_LOG_WARN,LOG,__VA_ARGS__)// 定义LOGW类型#define LOGE(...) __android_log_print(ANDROID_LOG_ERROR,LOG,__VA_ARGS__)// 定义LOGE类型#define LOGF(...) __android_log_print(ANDROID_LOG_FATAL,LOG,__VA_ARGS__)// 定义LOGF类型
上面的日志级别和Android中的log是对应的。
(3) 经过上面两步,我们就可以打印日志啦
intlen =5;LOGE("我是log %d",len);
现在我们就可以在logcat中看到我们打印的日志啦。
2 . 查看报错信息
首先我们先手动写一个错误,我们在上面的C文件中找一个函数,里面写入如下代码:
int * p = NULL;*p =100;
上面是一个空指针异常,我们运行程序,发现崩溃了,然后查看控制台,只有下面一行信息:
libc:Fatal signal 11 (SIGSEGV), code 1, fault addr 0x0 in tid 17481
完全看不懂上面的信息好吧,这个也太不明显了,下面我们就学习一下如何将上面的信息变得清楚明了
我们需要用到是ndk-stack工具,它在我们的ndk根目录下,它可以帮助我们把上面的信息转化为更为易懂更详细的报错信息,下面看看怎么做:
(1) 打开AndroidStudio中的命令行,输入adb logcat > log.txt
上面这句我们是使用adb命令捕获log日志并写入log.txt文件,然后我们就可以在项目根目录下看到log.txt文件
(2) 将log.txt打开看到报错信息,如下:
F/libc (17481): Fatal signal11 (SIGSEGV), code1, fault addr0x0 in tid17481 (dekong.ndkdemo1)I/DEBUG (67): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***I/DEBUG (67): Build fingerprint:'generic/vbox86p/vbox86p:5.0/LRX21M/genymotion08251046:userdebug/test-keys'I/DEBUG (67): Revision:'0'I/DEBUG (67): ABI:'x86'I/DEBUG (67): pid:17481, tid:17481, name: dekong.ndkdemo1 >>> com.codekong.ndkdemo1 <<I/DEBUG (67): #03 pc a4016838 I/DEBUG (67):I/DEBUG (67): Tombstone written to: /data/tombstones/tombstone_05
现在的报错信息还是看不懂,所以我们需要使用ndk-stack转化一下:
(3) 继续在AndroidStudio中的命令行中输入如下命令(在这之前,我们必须要将ndk-stack的路径添加到环境变量,以便于我们在命令行中直接使用它)
ndk-stack-sym app/build/intermediates/cmake/debug/obj/x86-dump./log.txt
上面的-sym后面的参数为你的对应平台(我是Genymotion模拟器,x86平台)的路径,如果你按照上面的步骤改了路径,那就需要写改过的路径,-dump后面的参数就是我们上一步得出的log.txt文件,执行结果如下:
********** Crash dump:**********Build fingerprint:'generic/vbox86p/vbox86p:5.0/LRX21M/genymotion08251046:userdebug/test-keys'pid:17481, tid:17481, name: dekong.ndkdemo1>>> com.codekong.ndkdemo1<<: Unableto open symbol file app/build/intermediates/cmake/debug/obj/x86/. Error (22): Invalid argumentStack frame I/DEBUG (67):#03 pc a4016838: Unableto open symbol file app/build/intermediates/cmake/debug/obj/x86/. Error (22): Invalid argument
Crash dump is completed
尤其是上面的一句:
g_ndkdemo1_MainActivity_updateFile+150): Routine Java_com_codekong_ndkdemo1_MainActivity_updateFile at F:\AndroidFirstCode\NDKDemo1\app\src\main\cpp/HelloJNI.c:32
准确指出了发生错误的行数