CMake
? 在android studio 2.2及以上嬉挡,構建原生庫的默認工具是 CMake。
? CMake是一個跨平臺的構建工具赦邻,可以用簡單的語句來描述所有平臺的安裝(編譯過程)校辩。能夠輸出各種各樣的makefile或者project文件。Cmake 并不直接建構出最終的軟件臼婆,而是產生其他工具的腳本(如Makefile ),然后再依這個工具的構建方式使用幌绍。
? CMake是一個比make更高級的編譯配置工具颁褂,它可以根據(jù)不同平臺、不同的編譯器傀广,生成相應的Makefile或者vcproj項目颁独。從而達到跨平臺的目的。Android Studio利用CMake生成的是ninja伪冰,ninja是一個小型的關注速度的構建系統(tǒng)誓酒。我們不需要關心ninja的腳本,知道怎么配置cmake就可以了贮聂。從而可以看出cmake其實是一個跨平臺的支持產出各種不同的構建腳本的一個工具靠柑。
CMake的腳本名默認是CMakeLists.txt
#cmake最低版本
cmake_minimum_required(VERSION 3.6.0)
#指定項目
project(Main)
#生成可執(zhí)行文件 main
add_executable(main main.c)
#執(zhí)行cmake . 生成makefile
#再執(zhí)行make即可生成main程序
如果源文件很多,那么一個個寫進去是一件很麻煩的事情吓懈,這時候可以:
cmake_minimum_required(VERSION 3.6.0)
project(Main)
#查找當前目錄所有源文件 并將名稱保存到 DIR_SRCS 變量
#不能查找子目錄
aux_source_directory(. DIR_SRCS)
message(${DIR_SRCS})
#也可以
file(GLOB DIR_SRCS *.c)
add_executable(main ${DIR_SRCS})
如果在cmake中需要使用其他目錄的cmakelist
cmake_minimum_required (VERSION 3.6.0)
project (Main)
aux_source_directory(. DIR_SRCS)
# 添加 child 子目錄下的cmakelist
add_subdirectory(child)
# 指定生成目標
add_executable(main ${DIR_SRCS})
# 添加鏈接庫
target_link_libraries(main child)
#===========================================================================================
#child目錄下的cmake就是:
cmake_minimum_required (VERSION 3.6.0)
aux_source_directory(. DIR_LIB_SRCS)
# 生成鏈接庫 默認生成靜態(tài)庫
add_library (child ${DIR_LIB_SRCS})
#指定編譯為靜態(tài)庫
add_library (child STATIC ${DIR_LIB_SRCS})
#指定編譯為動態(tài)庫
add_library (child SHARED ${DIR_LIB_SRCS})
在上面的例子中都是生成可執(zhí)行文件歼冰,讓我們對cmakelist有了一定的了解。現(xiàn)在到android studio中使用cmakelist
#NDK中已經有一部分預構建庫 ndk庫已經是被配置為cmake搜索路徑的一部分 所以可以
findLibrary(log-lib log)
target_link_libraries( native-lib
${log-lib} )
#設置cflag和cxxflag
#定義預編譯宏:TEST
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DTEST" )
set(CMAKE_Cxx_FLAGS "${CMAKE_Cxx_FLAGS} -DTEST" )
#其實直接這樣就行
target_link_libraries( native-lib
log )
添加其他預編譯庫(已經提前編譯好的庫)
#使用 IMPORTED 標志告知 CMake 只希望將庫導入到項目中
#如果是靜態(tài)庫則將shared改為static
add_library( imported-lib
SHARED
IMPORTED )
# 參數(shù)分別為:庫耻警、屬性隔嫡、導入地址、so所在地址
set_target_properties(
imported-lib
PROPERTIES
IMPORTED_LOCATION
${CMAKE_SOURCE_DIR}/src/${ANDROID_ABI}/libimported-lib.so )
#為了確保 CMake 可以在編譯時定位頭文件
#這樣就可以使用 #include <xx> 引入
#否則需要使用 #include "path/xx"
include_directories( imported-lib/include/ )
#native-lib 是自己編寫的源碼最終要編譯出的so庫
target_link_libraries(native-lib imported-lib)
#===========================================================================================
#添加其他預編譯庫還可以使用這種方式
#使用-L指導編譯時庫文件的查找路徑
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Lxx")
#為了確保 CMake 可以在編譯時定位您的標頭文件
include_directories( imported-lib/include/ )
#native-lib 是自己編寫的源碼最終要編譯出的so庫
target_link_libraries(native-lib imported-lib)
常用指令:
#set命令表示聲明一個變量source 變量的值是后面的可變參數(shù)
set(source a b c)
message(${source})
#邏輯判斷 計較字符串
set(ANDROID_ABI "areambi-v7a")
if(${ANDROID_ABI} STREQUAL "areambi")
message("armv5")
elseif(${ANDROID_ABI} STREQUAL "areambi-v7a")
message("armv7a")
else()
endif()
//還可以在gradle中使用 arguments 設置一些配置
externalNativeBuild {
cmake {
arguments "-DANDROID_TOOLCHAIN=clang", //使用的編譯器clang/gcc
"-DANDROID_STL=gnustl_static" //cmake默認就是 gnustl_static
cFlags "" //這里也可以指定cflag和cxxflag,效果和之前的cmakelist里使用一樣
cppFlags ""
}
}
5.0及以下與6.0及以上的注意事項:
? 存在兩個動態(tài)庫libhello-jni.so
與 libTest.so
甘穿。
libhello-jni.so
依賴于libTest.so
(使用NDK下的ndk-depends
可查看依賴關系)腮恩,則:
//<=5.0:
System.loadLibrary("Test");
System.loadLibrary("hello-jni");
//>=6.0:
System.loadLibrary("hello-jni");
Android.mk
? 使用Android.mk在 >=6.0 設備上不能再使用預編譯動態(tài)庫(靜態(tài)庫沒問題):
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := Test
#libTest.so放在當前文件同目錄
LOCAL_SRC_FILES := libTest.so
#預編譯庫
include $(PREBUILT_SHARED_LIBRARY)
include $(CLEAR_VARS)
#引入上面的Test模塊
LOCAL_SHARED_LIBRARIES := Test
LOCAL_MODULE := hello-jni
LOCAL_SRC_FILES := hello-jni.c
include $(BUILD_SHARED_LIBRARY)
上面這段配置生成的libhllo-jni
在>=6.0設備中無法執(zhí)行。
CMake
? 使用CMakeList.txt在 >=6.0 設備上引入預編譯動態(tài)庫:
cmake_minimum_required(VERSION 3.4.1)
file(GLOB SOURCE *.c )
add_library(
hello-jni
SHARED
${SOURCE} )
#這段配置在6.0依然沒問題
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -L[SO所在目錄]")
#這段配置只能在6.0以下使用 原因和android.mk一樣
#add_library(Test SHARED IMPORTED)
#set_target_properties(Test PROPERTIES IMPORTED_LOCATION [SO絕對地址])
target_link_libraries( hello-jni Test )
注意事項
? 從6.0開始 使用Android.mk 如果來引入一個預編譯動態(tài)庫 有問題
在4.4上 如果load一個動態(tài)庫 扒磁,需要先將這個動態(tài)庫的依賴的其他動態(tài)庫load進來
在6.0以下 System.loadLibrary 不會自動為我們加載依賴的動態(tài)庫
6.0以上 System.loadLibrary 會自動為我們加載依賴的動態(tài)庫