C/C++移植iOS(CMake编译与链接)

背景:
需要把Linux下的C/C++代码移植到iOS平台下,iOS APP链接编译的静态库和动态库进行测试。

工具准备:
     mac一台
     cmake
     xcode

github上有一个iOS版的Cmake编译工具链：ios-cmake
基于该Cmake编译工具链将C/C++代码编译成iOS平台可用的静态库或者动态库。

编译

• 进入/C/C++源码目录下，新建ios.toolchain.cmake文件编辑内容如：ios.toolchain.cmake
  
• 接着继续新建CMakeLists.txt

vi CMakeLists.txt

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

cmake_minimum_required(VERSION 3.2)
project (gmhelper C CXX)

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

# 源文件
# aux_source_directory为包含指定目录下所有的源文件
# 若不需要包含所有的源文件，则使用set定义，如：set(SRC_FILES 1.cpp 2.cpp)
# aux_source_directory(. SRC_FILES)
set(SRC_FILES
    xxx1.cpp
    xxx2.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)

• 新建build目录用于存放编译输出文件

mkdir build
cd build
#注：-DENABLE_BITCODE=FALSE 此处默认将bitcode模式关闭 如果链接的第三方库支持bitcode模式可以不加-DENABLE_BITCODE=FALSE
cmake .. -G Xcode -DCMAKE_TOOLCHAIN_FILE=../ios.toolchain.cmake -DPLATFORM=OS64 -DENABLE_BITCODE=FALSE

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

• 此时Release-iphonesimulator目录里会生成编译好的静态库（动态库编译只需将CMakeLists.txt里add_library的STATIC改为SHARED即可）
  
• 结合-DPLATFORM以及-DARCHS我们可以编译输出任意架构的库

#-DPLATFORM编译参数
Set -DPLATFORM to "SIMULATOR" to build for iOS simulator 32 bit (i386) DEPRECATED
Set -DPLATFORM to "SIMULATOR64" (example above) to build for iOS simulator 64 bit (x86_64)
Set -DPLATFORM to "OS" to build for Device (armv7, armv7s, arm64)
Set -DPLATFORM to "OS64" to build for Device (arm64)
Set -DPLATFORM to "OS64COMBINED" to build for Device & Simulator (FAT lib) (arm64, x86_64)
Set -DPLATFORM to "TVOS" to build for tvOS (arm64)
Set -DPLATFORM to "TVOSCOMBINED" to build for tvOS & Simulator (arm64, x86_64)
Set -DPLATFORM to "SIMULATOR_TVOS" to build for tvOS Simulator (x86_64)
Set -DPLATFORM to "WATCHOS" to build for watchOS (armv7k, arm64_32)
Set -DPLATFORM to "WATCHOSCOMBINED" to build for watchOS & Simulator (armv7k, arm64_32, i386)
Set -DPLATFORM to "SIMULATOR_WATCHOS" to build for watchOS Simulator (i386)
# -DARCHS 可以指定编译某种架构的库
  -DARCHS=armv7 则可以只编译armv7架构的库

链接

• 现在我们可以通过xcode新建一个app来测试编译的静态库或者动态库.
  
  首先xcode新建一个项目

• 配置项目设置（我使用的是Release版的库，结合自身进行更改）

• 指定头文件路径和库链接路径
  

• 添加链接的静态库和动态库 （注：如果链接动态库需要在Copy Files 里将动态库添加进去 否则运行app时会出现image can not find）
  

• #include头文件以及代码调用
  

• 此处确保运行与链接版本的一致性
  

• 运行app时出现引用C++标准库头文件错误
  

• 将.m文件更改为.mm
  

OK，APP运行成功。