iOS 使用 Cmake 生成 framework 库

背景

公司有一部分库是一套c++代码，要在android和iphone两种手机上运行，就要在分别编译android和iphone两个平台下的动态库。android开发目前是用 Android Studio(SDK/NDK), iphone开发是用XCode.当你增加或减少一个源代码文件后，要在Android Studio和XCode内分别添加这个源代码。随着时间的推移，源文件变来变去，你会烦不胜烦。

目的

本文描述如何用cmake，在android和iphone两个平台下，生成各自的库文件，供app调用

安装 cmake

如何安装再次就不过多的累赘了，各位看官老爷们自行百度吧，安装完成后我们可以通过命令行 cmake --version 语句来查看

[图片上传失败...(image-81990b-1622798273971)]

制作CMakeLists.txt

根据 cmake 官方文档 framework，制作的CMakeLists.txt内容如下,注意放在 C/C++ 源码目录下:

#注：此处TestDemo为我编译的静态库名字，需要替换
#DROOT是系统变量，主要指定头文件和链接库的路径 此处可替换成自己对应路径

cmake_minimum_required(VERSION 3.2)
project (TestDemo C CXX)

MESSAGE( STATUS "CMAKE_CXX_FLAGS: " ${CMAKE_CXX_FLAGS} )
# 工程名
set(PROJECT_NAME TestDemo)

# 源文件
# aux_source_directory为包含指定目录下所有的源文件
# 若不需要包含所有的源文件，则使用set定义，如：set(SRC_FILES 1.cpp 2.cpp)
# aux_source_directory(. SRC_FILES)
set(SRC_FILES
    CXX.cpp)

# 头文件
# 若指定多个目录，使用空格分隔 .表示当前项目路径
include_directories($ENV{DROOT}/inc .)


# 编译时链接路径 此处对不同架构时的链接路径做了一些处理（如果不需要链接其他库可以注释掉）
if(${ARCHS} STREQUAL "arm64")
    set(LIB_DIR ios_arm64_r)
elseif(${ARCHS} STREQUAL "armv7")
    set(LIB_DIR ios_armv7_r)
elseif(${ARCHS} STREQUAL "armv7s")
    set(LIB_DIR ios_armv7s_r)
elseif(${ARCHS} STREQUAL "i386")
    set(LIB_DIR ios_i386_r)
elseif(${ARCHS} STREQUAL "x86_64")
    set(LIB_DIR ios_x86_64_r)
endif()
    link_directories($ENV{DROOT}/bin/${LIB_DIR})

# 生成目标 STATIC和ARCHIVE对应静态库 SHARED和LIBRARY对应动态库
    add_library(${PROJECT_NAME} STATIC ${SRC_FILES})

# 链接/安装
    target_link_libraries(${PROJECT_NAME}  pthread dl)

有了 CMakeLists.txt 我们还需要一个 ios.toolchain.cmake 文件，文件的编辑内容如：ios.toolchain.cmake

Build

在同级目录下新建 build 目录用于存放编译输出文件

mkdir build
cd build
cmake .. -G Xcode -DCMAKE_TOOLCHAIN_FILE=../ios.toolchain.cmake -DPLATFORM=OS64 -DENABLE_BITCODE=FALSE


#注：-DENABLE_BITCODE=FALSE 此处默认将bitcode模式关闭 如果链接的第三方库支持bitcode模式可以不加-DENABLE_BITCODE=FALSE

操作过后如下

企业微信截图_66e4569c-840c-442e-a707-ffeedb855cca.png

然后继续执行

cmake --build . --config Debug

#注：gmhelper.xcodeproj 可以通过xcode打开进行继续编译
#不过也可以继续选择命令行编译 （需要编译 Release 版将替换 Debug 即可）

此时 Debug-iphoneos 目录里会生成编译好的静态库（动态库编译只需将 CMakeLists.txt 里 add_library 的 STATIC 改为 SHARED 即可）

企业微信截图_df4d929e-9e9c-4d7f-ab37-1e9d940f5e58.png

结合 -DPLATFORM 以及 -DARCHS 我们可以编译输出任意架构的库

image.png

在这里我只是简单讲解了使用及其流程，后边我们可以将这些命令写成脚本，然后配置也可以做成动态的， git 一个方便的小工具,感兴趣的可以去看看 ios-cmake