緣起
生活不止眼前的茍且韭山,還有詩與遠(yuǎn)方郁季。如果你是個(gè)菜鳥,想成為一個(gè)萬人敬仰的大神钱磅,那么你不妨先給自己定個(gè)小目標(biāo)梦裂,比如說先活它個(gè)200年,然后向天再借500年续搀。嗯塞琼,第一次聽到它的時(shí)候,一顆心不停的顫抖禁舷,好像前生彼此曾擁有彪杉,今生卻等了很久很久∏A跨平臺(tái)作業(yè)的腳本派近,簡(jiǎn)單的風(fēng)格,正處于青春期的 cmake洁桌,蓬勃的生機(jī)與活力渴丸,讓人忍不住為之著迷。
介紹
Cmake 是什么另凌?巨頭百度說了:
CMake 是一個(gè)跨平臺(tái)的安裝工具谱轨,可以用簡(jiǎn)單的語句來描述所有平臺(tái)的安裝(編譯過程)。他能夠輸出各種各樣的makefile或者project文件吠谢,能測(cè)試所支持的C++特性土童,類似UNIX下的automake。CMake 可以編譯工坊、制作献汗、產(chǎn)生適配器(wrapper)、還可以用任意的順序建構(gòu)王污。CMake 支持 in-place 建構(gòu)(二進(jìn)檔和源代碼在同一個(gè)目錄樹中)和 out-of-place 建構(gòu)(二進(jìn)檔在別的目錄里)罢吃,因此可以很容易從同一個(gè)源代碼目錄樹中建構(gòu)出多個(gè)二進(jìn)檔。CMake 也支持靜態(tài)與動(dòng)態(tài)程式庫的建構(gòu)昭齐∧蛘校“CMake”這個(gè)名字是“cross platform make”的縮寫。
簡(jiǎn)單而言,對(duì)于我們泊业,就是生成so把沼。
準(zhǔn)備工作
對(duì)于 cmake,as 的支持來得有點(diǎn)晚吁伺,直到 as 2.2 之后才開始饮睬。所以 as 較低版本的,請(qǐng)升級(jí)篮奄,如有不便捆愁,請(qǐng)聯(lián)系谷歌客服。升級(jí)完畢窟却,打開 SDKManager昼丑,還有幾個(gè)小插件需要安裝。比如說 cmake 插件夸赫,這個(gè)你不裝不行菩帝,如果,假如說如果茬腿,不好意思這里沒有如果呼奢。比如說 NDK 插件,套用官方的話說切平,原生開發(fā)工具包握础,允許您為 Android 使用 C 和 C++ 代碼,并提供眾多平臺(tái)庫悴品。比如說 LLDB 插件禀综,調(diào)試原生代碼,可選項(xiàng)苔严,推薦使用定枷。
上圖,從官網(wǎng)文檔截取届氢,請(qǐng)自主勾選需要項(xiàng)欠窒。如果你嫌煩,一鍵勾選所有悼沈,耐心等待個(gè)三天三夜贱迟,我連手帶腳支持姐扮。
征程開始
出師未捷身先死絮供,啊呸,這個(gè)茶敏,這個(gè)我們還是回歸正題壤靶,開始我們的 hello jni 征途。一個(gè)目標(biāo)(項(xiàng)目支持 cmake)惊搏,兩條途徑贮乳。其中一條捷徑忧换,創(chuàng)建一個(gè)新項(xiàng)目,選中 Include C++ Support 復(fù)選框向拆。對(duì)于這種方式亚茬,沒什么需要解釋的,下一步浓恳,下一步刹缝。
另外一條就是在已有項(xiàng)目中支持 cmake,分幾個(gè)步驟颈将。
步驟1. 在 src/main 目錄下創(chuàng)建一個(gè)目錄梢夯,取名叫 cpp。這個(gè)命名隨意晴圾,你喜歡就好颂砸。把需要引入的代碼放入創(chuàng)建的目錄下,這里千萬別隨意死姚,不能鬧情緒人乓。
步驟2. 創(chuàng)建 CMake 構(gòu)建腳本,一個(gè)純文本文件知允,取名 CMakeLists.txt撒蟀,這個(gè)命名固定格式,不允許有脾氣温鸽。至于這個(gè)文件你放哪里保屯,隨你喜歡好了。
步驟3. 在 app module 中的 build.gradle 文件中涤垫,給予 cmake 支持姑尺。
android{
...
externalNativeBuild {
cmake {
path "src/main/cpp/CMakeLists.txt"
}
}
}
第一個(gè)配置,聲明 Native Build 方式為 cmake蝠猬,并指定 cmake 腳本路徑切蟋。
android{
...
defaultConfig{
...
externalNativeBuild {
cmake {
cppFlags "-std=c++11 -frtti -fexceptions"
}
}
}
}
喲喲,走過路過看過別錯(cuò)過榆芦。第二個(gè)配置柄粹,設(shè)置 cmake 編譯的條件,比如說 c11++ 標(biāo)準(zhǔn)匆绣。同樣都是 externalNativeBuild驻右,這里是在 defaultConfig 域,而 cmake path 是 android 域崎淳。我有時(shí)候想堪夭,為什么不合二為一呢,非要讓人寫兩遍,頭疼森爽,此處不求甚解恨豁。
征途關(guān)鍵,cmake 的配置
cmake 的文檔爬迟,E文橘蜜,讓人沉醉于其中,不能自拔付呕。有這么幾個(gè) api扮匠,比較重要。
重要1. add_library凡涩,生成 lib棒搜。對(duì)于我們而言,System.loadLibrary("xxx")活箕,這里的 xxx 就是我們的lib力麸。 示例如下:
# 創(chuàng)建一個(gè) lib,靜態(tài) or 動(dòng)態(tài)育韩,可創(chuàng)建多個(gè)
add_library( # lib名稱
JniDemo
# lib類型
SHARED
# .c/cpp目錄
jni_dynamic.cpp )
重要2. set_target_properties克蚂,用來使用 .a 等已構(gòu)建好的 lib。示例如下:
# 添加自己的 lib 庫
add_library( libHello
SHARED
# 由于.a 已經(jīng)屬于已經(jīng)構(gòu)建好的庫筋讨,使用 IMPORTED 標(biāo)志埃叭,告訴 cmake 不需要編譯了
IMPORTED )
set_target_properties(
#名稱
libHello
# 指定要定義的參數(shù).
PROPERTIES IMPORTED_LOCATION
# 導(dǎo)入 lib 的路徑
${CMAKE_SOURCE_DIR}/sources/${ANDROID_ABI}/libHello.a)
重要3. find_library,查找 lib悉罕。示例如下:
# 搜索 NDK 指定 lib
find_library( # lib 路徑變量的名稱赤屋。
log-lib
# 查找指定 lib 名稱
log )
重要4. target_link_libraries,鏈接所有 lib壁袄,生成新的 lib类早,示例如下:
# 鏈接庫
target_link_libraries( # 指定目標(biāo) lib
JniDemo
# 自己的 lib
libHello
# NDK log lib //這里放 find 的路徑 ${log-lib} 也是可以
log )
暫且就講這么幾個(gè),基本上應(yīng)該也差不多可以滿足了嗜逻。如果涩僻,那么請(qǐng)自覺查看 cmake 文檔,我想你會(huì)喜歡的栈顷。這里有個(gè)事還是提一下逆日,對(duì)于上邊四個(gè)重點(diǎn),有兩個(gè)是重中之重萄凤。重點(diǎn)1室抽,是生成 lib,建立 java 與 c/c++ 之間的橋梁蛙卤。重點(diǎn)4狠半, 是鏈接所有 lib, 建立一個(gè)完整的可運(yùn)行 lib颤难。這兩個(gè)神年,基本也可以解決問題了。至于多余的兩個(gè)重點(diǎn)行嗤,為了結(jié)構(gòu)比較清晰已日,直觀罷了。
分享征途喜悅
到了這栅屏,jni 就告一段路了飘千。至于前邊想的,算是有一個(gè)可喜的圓滿結(jié)局了栈雳。我之所以這么認(rèn)真的待 jni护奈,是因?yàn)槲以敢猓蚁矚g哥纫。若能以此換回對(duì) jni 的認(rèn)知霉旗,了解,固然可喜蛀骇。如是沒有厌秒,我也沒有什么可后悔的了。
附送一張github機(jī)票擅憔,帶你領(lǐng)略世界的浩瀚