CMake基本配置与注意事项
CMake基本配置与注意事项
- CMake手册 https://www.zybuluo.com/khan-lau/note/254724
- Makefile语法详解 https://quanzhuo.github.io/2016/06/06/Makefile
CMake
在android studio 2.2及以上,构建原生库的默认工具是 CMake。
CMake是一个跨平台的构建工具,可以用简单的语句来描述所有平台的安装(编译过程)。能够输出各种各样的makefile或者project文件。Cmake 并不直接建构出最终的软件,而是产生其他工具的脚本(如Makefile ),然后再依这个工具的构建方式使用。
CMake是一个比make更高级的编译配置工具,它可以根据不同平台、不同的编译器,生成相应的Makefile或者vcproj项目。从而达到跨平台的目的。Android Studio利用CMake生成的是ninja,ninja是一个小型的关注速度的构建系统。我们不需要关心ninja的脚本,知道怎么配置cmake就可以了。从而可以看出cmake其实是一个跨平台的支持产出各种不同的构建脚本的一个工具。
CMake的脚本名默认是CMakeLists.txt
#cmake最低版本 cmake_minimum_required(VERSION 3.6.0) #指定项目 project(Main) #生成可执行文件 main add_executable(main main.c) #执行cmake . 生成makefile #再执行make即可生成main程序
message打印日志
可以使用message("打印日志")
来打印日志
# log 信息输出的查看 # 以前的Cmake版本都是在output.txt, 现在最新版本Cmake在metadata_generation_stderr.txt或cmake_server_log, # 路径`./app/.cxx/cmake/debug/armeabi-v7a/cmake_server_log.txt` # 想及时更新你的日志,请安装一次即可 or Linked_C++_Projects # 在Build也可以查看,注意:是点击Sync Now 才会看到 #[[ (无) = 重要消息; STATUS = 非重要消息; WARNING = CMake 警告, 会继续执行; AUTHOR_WARNING = CMake 警告 (dev), 会继续执行; SEND_ERROR = CMake 错误, 继续执行,但是会跳过生成的步骤; FATAL_ERROR = CMake 错误, 终止所有处理过程; ]] message(STATUS "1SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "2SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "3SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "4SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "5SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "6SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "7SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "8SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "9SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message(STATUS "0SuccessD>>>>>>>>>>>>>>>>>>>>>>>>>>>>") message("10 OldCmakeVersion:output.txt, NewCmakeVersion:cmake_server_log.txt")
find_library查找一个NDK工具中的库
在创建一个新的C++项目工程后,在CMakeLists.txt
中都会有find_library(log-lib log )
这个函数,表示的是查找一个NDK工具中的log的动态库。
思考:我如何知道哪些库是可以写的,你怎么知道些一个log就可以?
答:请查看 D:\Android\Sdk\ndk\21.4.7075529\build\cmake\system_libs.cmake
思考:
D:\Android\Sdk\ndk\21.0.6113669\toolchains\llvm\prebuilt\windows-x86_64\sysroot\usr\lib\arm-linux-androideabi\16\liblog.so
问题1:你怎么知道是在 21.4.7075529?,问题2:为啥是arm-linux-androideabi
?,问题3;为啥是16?
答:?1 (因为local.properties指定了NDK版本,或者是你当前的NDK版本)
答:?2 (因为我的手机是arm32的,而且在项目的build.gradle
中配置了"armeabi-v7a" 所以是arm-linux-androideabi
)
答:?3 (因为项目中的minSdkVersion
是16)
添加多个源文件
如果源文件很多,那么一个个写进去是一件很麻烦的事情,这里有两种方法:
file(GLOB source src/main/cmake/*.c src/main/cmake/*.cpp)
# GLOB是固定的写法,source是一个变量名,表示src/main/cmake/下面的所有.c和.cpp文件添加到source里面来aux_source_directory(. DIR_SRCS)
# 查找当前目录所有源文件 并将名称保存到 DIR_SRCS 变量,不能查找子目录
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中引用其他的 CMake
如果在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) # 生成链接库 默认生成静态库 add_library (child ${DIR_LIB_SRCS}) #指定编译为静态库 add_library (child STATIC ${DIR_LIB_SRCS}) #指定编译为动态库 add_library (child SHARED ${DIR_LIB_SRCS})
在上面的例子中都是生成可执行文件,让我们对cmakelist有了一定的了解。现在到android studio中使用cmakelist
#NDK中已经有一部分预构建库 ndk库已经是被配置为cmake搜索路径的一部分 所以可以 findLibrary(log-lib log) target_link_libraries( native-lib ${log-lib} ) #设置cflag和cxxflag #定义预编译宏:TEST,-D就是定义预编译宏的意思 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DTEST" ) set(CMAKE_Cxx_FLAGS "${CMAKE_Cxx_FLAGS} -DTEST" ) #其实直接这样就行 target_link_libraries( native-lib log )
添加其他预编译库
添加其他预编译库(已经提前编译好的库)
#使用 IMPORTED 标志告知 CMake 只希望将库导入到项目中 #如果是静态库则将shared改为static add_library( imported-lib SHARED IMPORTED ) # 参数分别为:库、属性、导入地址、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_C_FLAGS = ${CMAKE_C_FLAGS} + 自己设置的值(${CMAKE_C_FLAGS} (原来的CMAKE_C_FLAGS变量的值 + 自己定义的值) # 如果有多个路径:set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS}" -LXXX -LXXX -LXXX) set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Lxx") # 为了确保 CMake 可以在编译时定位您的标头文件 include_directories( imported-lib/include/ ) # native-lib 是自己编写的源码最终要编译出的so库 target_link_libraries(native-lib imported-lib)
像这些CMAKE_SOURCE_DIR
和ANDROID_ABI
等都是CMake内部预设好了的,它们是在.../Android/sdk/cmake/3.6.4111459/android.toolchain.cmake
这个文件,我们在执行CMakeLists.txt
的时候,会去读取android.toolchain.cmake
这个文件
常用指令:
#set命令表示声明一个变量source 变量的值是后面的可变参数 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及以上的注意事项:
存在两个动态库 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");
- 在4.4上 如果load一个动态库 ,需要先将这个动态库的依赖的其他动态库load进来
- 在6.0以下 System.loadLibrary 不会自动为我们加载依赖的动态库
- 在6.0以上 System.loadLibrary 会自动为我们加载依赖的动态库
Android.mk
使用Android.mk在 >=6.0 设备上不能再使用预编译动态库(静态库没问题):
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设备中无法执行。目前还没有找到在>=6.0设备的解决方法,最好是使用CMake
CMake
使用CMakeList.txt在 >=6.0 设备上引入预编译动态库:
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 )
Android NDK 开发:CMake 使用
CMake 入门实战
CMake 使用教程
CMake使用简介及CMakeList.txt编写
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· DeepSeek “源神”启动!「GitHub 热点速览」
· 我与微信审核的“相爱相杀”看个人小程序副业
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· C# 集成 DeepSeek 模型实现 AI 私有化(本地部署与 API 调用教程)
· spring官宣接入deepseek,真的太香了~