以前cmake配置都是一些简单的SO库,静态库的配置。然后本次因工作需要对C++源码项目工程配置链接发生了很多很多问题,记录下。
一、Cmake配置的基本步骤语法:
cmake_minimum_required(VERSION 3.10.2)
#项目名称
project("JniNative")
#定义宏 PLATFORM_ANDROID,区分安卓使用 GLESv3 而不是使用Win的 glew.h
add_definitions(-DPLATFORM_ANDROID)
#1、设置路径变量 PROJECT_SOURCE_DIR 是Cmake的变量,表示CmakeLists.txt目录当前的层次结构
set(ROOT ${PROJECT_SOURCE_DIR}/nativeLib/)
# 1.2 链接Engine目录下的cmakeList.txt 库的工程名:engine ,在最后在link添加到jni SO库的依赖中
include(${ENGINE_ROOT}/CMakeLists.txt)
# 2、engine工程包含的目录路径,主要是涉及源码里对头文件引入的目录层级
include_directories(
${ENGINE_ROOT}/sdk
${ENGINE_ROOT}/sdk/events
.......
)
# 2.2 Jni层-包含头文件
include_directories(
${PROJECT_SOURCE_DIR}/include
${PROJECT_SOURCE_DIR}/utils
)
#引入第三方的SO库是采用set_target_properties
set(3RD_LIB ${PROJECT_SOURCE_DIR}/../jniLibs)
add_library(libruntime SHARED IMPORTED)
set_target_properties(
libruntime
PROPERTIES
IMPORTED_LOCATION
${3RD_LIB}/${ANDROID_ABI}/libruntime.so
)
#Jni层源文件 file语法 GLOB_RECURSE 表示递归遍历获取该目录下所有的文件,包含子目录
file(GLOB_RECURSE JNI_ROOT_SRC ${PROJECT_SOURCE_DIR}/*.cpp)
file(GLOB_RECURSE JNI_SDK_SRC ${PROJECT_SOURCE_DIR}/sdk/*.cpp)
# 3、Jni层cpp源码
set(JNI_SOURCE_FILE
${JNI_ROOT_SRC}
${JNI_SDK_SRC}
)
# 4、将源码添加到库中
add_library(
inkNative #自己库的名称
SHARED # 动态库
${JNI_SOURCE_FILE} #JNI 的源文件
)
# find_library 是用来查找NDK的官方库的,
#官方库的路径:${SDK}\ndk\21.1.6352462\platforms\android-29\arch-arm64\usr\lib
find_library(
log-lib
log )
#查找android libEGL库
find_library(
EGL-lib
EGL )
#查找android libGLESv3库
find_library(
GLESv3-lib
GLESv3 )
# 5、最后链接库,同时也是链接需要依赖的第三方库,比如:其他的So,或者源码工程
target_link_libraries( # Specifies the target library.
inkNative
${log-lib}
${EGL-lib}
${GLESv3-lib}
libruntime #第三方库
# 这就是引入的C++的源码工程,这个是在另一个cmakeList中通过include引进来的,这个后面在继续说明
engine
)
以上就是基本的cmake语法配置。
建议:如果因为添加配置的源码工程比较大,建议根据工程数分开配置cmake,这样方便维护。
比如:当前android Demo (JNI层)、Engine(C++ 源码工程)、Events(C++ 源码工程);那么就可以各个工程目录下写3个cmakeLists.txt配置文件,然后在JNI层的CmakeLists.txt中通过include语法引入即可,如上方的1.2步骤。
详细描述下配置过程中遇到的问题:
1、问题:在JNI中的cmake引入其他cmakeLists.txt ,链接不到源码文件,导致一直导致一直报错提示 [CMake无法确定目标的链接器语言]。
解决:存在多个cmake引入其他cmake时,一定要使用最外层(JNI层引入)传进去的根路径,不能在其他的cmake中使用 PROJECT_SOURCE_DIR或者CMAKE_CURRENT_SOURCE_DIR。否则无法识别到准确的文件位置。比如在上面的代码中的第1步骤,使用set语法定义ROOT,然后在1.2步骤include的Engine的cmake,在Engine的cmake中必须使用ROOT这个路径,而不能使用PROJECT_SOURCE_DIR或者CMAKE_CURRENT_SOURCE_DIR。
2、问题:源码中存在很多不兼容安卓平台代码,比如 特定的win32才能使用的等,通常会导致编译失败;
解决:在cmake中配置宏定义过滤,如:
#定义宏 PLATFORM_ANDROID,区分安卓使用 GLESv3 而不是使用Win的 glew.h
# 宏定义的语法:add_definitions,其中以 -D开头
add_definitions(-DPLATFORM_ANDROID)
3、其中还涉及android NDK的官方库如:log、GLESv3、android、EGL等,官方库的路径:${SDK}\ndk\21.1.6352462\platforms\android-29\arch-arm64\usr\lib
引入语法:
# find_library 是用来查找NDK的官方库的,
#官方库的路径:${SDK}\ndk\21.1.6352462\platforms\android-29\arch-arm64\usr\lib
#查找android liblog库
find_library(
log-lib
log )
#查找android libEGL库
find_library(
EGL-lib
EGL )
#查找android libGLESv3库
find_library(
GLESv3-lib
GLESv3 )
#最后链接到自己的项目中
target_link_libraries(
inkNative
${log-lib}
${EGL-lib}
${GLESv3-lib}
)