CMake 安卓NDK编译常用语法

CMake 安卓NDK编译常用语法

CMake版本

cmake_minimum_required(VERSION 3.5)

设置项目名称

project(my_project_name)

• 设置之后使用${PROJECT_NAME}就可以得到项目名称

###常用的内置变量

• PROJECT_NAME
  • 返回通过 PROJECT 定义的项目名称
• CMAKE_C_FLAGS
  • 编译 C 文件时的选项，默认为空
• CMAKE_CXX_FLAGS
  • 编译 C++ 文件时的选项，默认为空
• CMAKE_SHARED_LINKER_FLAGS
  • 链接动态库时的选项，默认为空
• PROJECT_SOURCE_DIR
  • 工程的根目录，同CMAKE_SOURCE_DIR
• CMAKE_CXX_COMPILER_ID
  • 获取当前编译器ID，大部分是Clang、GNU、Intel、MSVC的其中一种
• ANDROID_ABI
  • 当前编译的安卓ABI类型，是armeabi-v7a、armeabi-v7a with NEON、arm64-v8a的其中一种

平台 32&64

if("${ANDROID_ABI}" STREQUAL "armeabi-v7a" OR "${ANDROID_ABI}" STREQUAL "armeabi-v7a with NEON")
    set(ANDROID_STL "gnustl_shared")
    set(ANDROID_TOOLCHAIN "gcc")
    set(STRIP_PATH "arm-linux-androideabi")
    message("current ABI is: ${ANDROID_ABI}")
elseif ("${ANDROID_ABI}" STREQUAL "arm64-v8a")
    set(ANDROID_STL "c++_shared")
    set(ANDROID_TOOLCHAIN "clang")
    set(STRIP_PATH "aarch64-linux-android")
    message("current ABI is: ${ANDROID_ABI}")
else()
    message(FATAL_ERROR "${ANDROID_ABI} is no support")
endif()

路径相关配置

# 设置cmake编译库输出的位置
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/libs/${ANDROID_ABI})

# 设置头文件搜索路径
include_directories(
	...
)

# 设置需要编译的源文件
file(
	GLOB SOURCE_FILES
	...
)

# 设置库文件搜索路径
link_directories(
	...
)

设置生成动态库文件

add_library(${PROJECT_NAME} SHARED ${SOURCE_FILES})

常用的编译和链接选项

编译选项

CMAKE_CCXX_FLAGS_RELEASE、CMAKE_CCXX_FLAGS_RELEASE

• -fno-rtti
  • 禁用运行时类型信息
• -fno-exceptions
  • 禁用异常机制
• -fPIC
  • 生成与位置无关代码
• -O3
  • 编译优化选项，常加到CMAKE_C/CXX_FLAGS_RELEASE中
• -ffunction-sections -fdata-sections
  • 可以减少库体积的优化选项
• -std=c++11
  • 使用c++11标准库，如果代码中有用到的话，加到CMAKE_CXX_FLAGS中

链接选项

CMAKE_SHARED_LINKER_FLAGS

• -Wl,-Bsymbolic
  • 优先使用库内符号，避免加载的时候使用了程序中其他同名静态变量
• -Wl,--gc-sections
  • 未使用的代码不会被链接，减少库体积
• -dead-strip
  • 删除未使用的符号，减少库体积

链接第三方库

# 设置需要链接的库文件
target_link_libraries(${PROJECT_NAME}
	...

• 常用的安卓库
  • android: jni库
  • log: 打印日志
  • jnigraphics: 安卓图片库
  • EGL: OpenGL相关
  • GLESv: OpenGLES2.0相关

导出有符号和无符号库

add_custom_command(TARGET ${PROJECT_NAME}
	POST_BUILD
	COMMAND cp ${PROJECT_SOURCE_DIR}/libs/${ANDROID_ABI}/libmbccore.so ${PROJECT_SOURCE_DIR}/obj/${ANDROID_ABI}/
	COMMAND ${ANDROID_NDK_PATH}/toolchains/${STRIP_PATH}-4.9/prebuilt/darwin-x86_64/bin/${STRIP_PATH}-strip --strip-all ${PROJECT_SOURCE_DIR}/libs/${ANDROID_ABI}/libmbccore.so
	COMMAND ditto 其他第三方.so库 ${PROJECT_SOURCE_DIR}/libs/${ANDROID_ABI}
)

• 注意这里的${ANDROID_NDK_PATH}需要通过外部指定进来