下面分別做介紹:
cmake_minimum_required(VERSION 3.4.1)用來設(shè)置在編譯本地庫時(shí)我們需要的最小的cmake版本,AndroidStudio自動(dòng)生成,我們幾乎不需要自己管。
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用來設(shè)置編譯生成的本地庫的名字為native-lib,SHARED表示編譯生成的是動(dòng)態(tài)鏈接庫(這個(gè)概念前面已經(jīng)提到過了),src/main/cpp/native-lib.cpp表示參與編譯的文件的路徑,這里面可以寫多個(gè)文件的路徑。
find_library是用來添加一些我們?cè)诰幾g我們的本地庫的時(shí)候需要依賴的一些庫,由于cmake已經(jīng)知道系統(tǒng)庫的路徑,所以我們這里只是指定使用log庫,然后給log庫起別名為log-lib便于我們后面引用,此處的log庫是我們后面調(diào)試時(shí)需要用來打log日志的庫,是NDK為我們提供的。
target_link_libraries是為了關(guān)聯(lián)我們自己的庫和一些第三方庫或者系統(tǒng)庫,這里把我們把自己的庫native-lib庫和log庫關(guān)聯(lián)起來。
NDK自定義配置
1 . 添加多個(gè)參與編譯的C/C++文件
首先,我們發(fā)現(xiàn)我們上面的例子都是涉及到一個(gè)C++文件,那么我們實(shí)際的項(xiàng)目不可能只有一個(gè)C++文件,所以我們首先要改變CMakeLists.txt文件,如下 :
add_library( HelloNDK? ? ? ? ? ? SHARED? ? ? ? ? ? src/main/cpp/HelloNDK.c? ? ? ? ? ? src/main/cpp/HelloJNI.c)
簡(jiǎn)單吧,簡(jiǎn)單明了,但是這里要注意的是,你在寫路徑的時(shí)候一定要注意當(dāng)前的CMakeLists.txt在項(xiàng)目中的位置,上面的路徑是相對(duì)于CMakeLists.txt寫的。
2 . 我們想編譯出多個(gè)so庫
大家會(huì)發(fā)現(xiàn),我們上面這樣寫,由于只有一個(gè)CMakeLists.txt文件,所以我們會(huì)把所有的C/C++文件編譯成一個(gè)so庫,這是很不合適的,這里我們就試著學(xué)學(xué)怎么編譯出多個(gè)so庫。
先放上我的項(xiàng)目文件夾結(jié)構(gòu)圖:

然后看看我們每個(gè)CMakeLists.txt文件是怎么寫的:
one文件夾內(nèi)的CMakeLists.txt文件的內(nèi)容:
ADD_LIBRARY(one-lib SHAREDone-lib.c)target_link_libraries(one-liblog)
two文件夾內(nèi)的CMakeLists.txt文件的內(nèi)容:
ADD_LIBRARY(two-lib SHAREDtwo-lib.c)target_link_libraries(two-liblog)
app目錄下的CMakeLists.txt文件的內(nèi)容
# 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文件的配置是支持繼承的,所以我們?cè)谧优渲梦募兄皇菍懥瞬煌奶厥馀渲庙?xiàng)的配置,最后在最上層的文件中配置子配置文件的路徑即可,現(xiàn)在編譯項(xiàng)目,我們會(huì)在<項(xiàng)目目錄>\app\build\intermediates\cmake\debug\obj\armeabi下面就可以看到生成的動(dòng)態(tài)鏈接庫。而且是三個(gè)動(dòng)態(tài)鏈接庫
3 . 更改動(dòng)態(tài)鏈接庫生成的目錄
我們是不是發(fā)現(xiàn)上面的so庫的路徑太深了,不好找,沒事,可以配置,我們只需要在頂層的CMakeLists.txt文件中加入下面這句就可以了
#設(shè)置生成的so動(dòng)態(tài)庫最后輸出的路徑set(CMAKE_LIBRARY_OUTPUT_DIRECTORY${PROJECT_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI})
然后我們就可以在app/src/main下看到j(luò)niLibs目錄,在其中看到我們的動(dòng)態(tài)鏈接庫的文件夾和文件(這里直接配置到了系統(tǒng)默認(rèn)的路徑,如果配置到其他路徑需要在gradle文件中使用jinLibs.srcDirs = ['newDir']進(jìn)行指定)。
NDK錯(cuò)誤調(diào)試
在開發(fā)的過程中,難免會(huì)遇到bug,那怎么辦,打log啊,下面我們就談?wù)劥騦og和看log的姿勢(shì)。
1 . 在C/C++文件中打log
(1) 在C/C++文件中添加頭文件
#include
1
上面是打印日志的頭文件,必須添加
(2) 添加打印日志的宏定義和TAG
//log定義#defineLOG"JNILOG"http:// 這個(gè)是自定義的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類型
上面的日志級(jí)別和Android中的log是對(duì)應(yīng)的。
(3) 經(jīng)過上面兩步,我們就可以打印日志啦
intlen =5;LOGE("我是log %d",len);
現(xiàn)在我們就可以在logcat中看到我們打印的日志啦。
2 . 查看報(bào)錯(cuò)信息
首先我們先手動(dòng)寫一個(gè)錯(cuò)誤,我們?cè)谏厦娴腃文件中找一個(gè)函數(shù),里面寫入如下代碼:
int * p = NULL;*p =100;
上面是一個(gè)空指針異常,我們運(yùn)行程序,發(fā)現(xiàn)崩潰了,然后查看控制臺(tái),只有下面一行信息:
libc:Fatal signal 11 (SIGSEGV), code 1, fault addr 0x0 in tid 17481
完全看不懂上面的信息好吧,這個(gè)也太不明顯了,下面我們就學(xué)習(xí)一下如何將上面的信息變得清楚明了
我們需要用到是ndk-stack工具,它在我們的ndk根目錄下,它可以幫助我們把上面的信息轉(zhuǎn)化為更為易懂更詳細(xì)的報(bào)錯(cuò)信息,下面看看怎么做:
(1) 打開AndroidStudio中的命令行,輸入adb logcat > log.txt
上面這句我們是使用adb命令捕獲log日志并寫入log.txt文件,然后我們就可以在項(xiàng)目根目錄下看到log.txt文件
(2) 將log.txt打開看到報(bào)錯(cuò)信息,如下:
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
現(xiàn)在的報(bào)錯(cuò)信息還是看不懂,所以我們需要使用ndk-stack轉(zhuǎn)化一下:
(3) 繼續(xù)在AndroidStudio中的命令行中輸入如下命令(在這之前,我們必須要將ndk-stack的路徑添加到環(huán)境變量,以便于我們?cè)诿钚兄兄苯邮褂盟?
ndk-stack-sym app/build/intermediates/cmake/debug/obj/x86-dump./log.txt
上面的-sym后面的參數(shù)為你的對(duì)應(yīng)平臺(tái)(我是Genymotion模擬器,x86平臺(tái))的路徑,如果你按照上面的步驟改了路徑,那就需要寫改過的路徑,-dump后面的參數(shù)就是我們上一步得出的log.txt文件,執(zhí)行結(jié)果如下:
********** 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
準(zhǔn)確指出了發(fā)生錯(cuò)誤的行數(shù)