用cmake生成ios framework库

用cmake生成ios framework库

cmake ios framework

2019/5/5

代码下载

cmake-ios-demo 版本1
cmake-ios-demo 版本2

背景

如果你开发了一套c++代码，要在android和iphone两种手机上运行，就要在分别编译android和iphone两个平台下的动态库。

android开发目前是用 Android Studio(SDK/NDK), iphone开发是用XCode.

当你增加或减少一个源代码文件后，要在Android Studio和XCode内分别添加这个源代码。

随着时间的推移，源文件变来变去，你会烦不胜烦。

目的

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

版本1

代码目录结构

我准备的演示代码目录如下:

代码目录	描述
tvm_model	能生成 android 和 iphone两个平台的库.
	tvm_model.hpp(开放给ios app调用)
	tvm_model.cc(功能实现函数)
	CMakeLists.txt : cmake 需要的项目文件
	android 平台: cmake生成的文件是libtvm_model.so
	ios 平台: cmake生成的文件是 tvm_model.framework
tvm_demo_android	android app, 调用 libtvm_model.so 库内的函数.
tvm_demo_ios	iphone app, 调用 tvm_model.framework 库内的函数.

检查cmake是否安装

用以下命令，确认你是否安装了cmake：
cmake --version

在我的mac机器上，输出是：
cmake version 3.13.1

制作CMakeLists.txt

根据CMake官方文档framework,resource，制作的CMakeLists.txt内容如下:

cmake_minimum_required(VERSION 3.11)

Project(tvm_model)
add_library(tvm_model SHARED
         tvm_model.cc
         tvm_model.hpp
)

set(RESOURCE_FILES
readme.md
# appresourcedir/appres.txt
)

set_target_properties(tvm_model PROPERTIES
FRAMEWORK TRUE
FRAMEWORK_VERSION A
MACOSX_FRAMEWORK_IDENTIFIER cn.tvm.tvm_model
# MACOSX_FRAMEWORK_INFO_PLIST Info.plist
# "current version" in semantic format in Mach-O binary file
VERSION 1.0.0
# "compatibility version" in semantic format in Mach-O binary file
SOVERSION 1.0.0
PUBLIC_HEADER tvm_model.hpp
XCODE_ATTRIBUTE_CODE_SIGN_IDENTITY "iPhone Developer"
RESOURCE "${RESOURCE_FILES}"
)

编译出 tvm_model.framework

用以下命令编译出库文件:

cd ./tvm_demo1/src/tvm_model
mkdir build
cd    build
cmake ..
make

Resources 没有被复制

我们期望 readme.md 被复制到 tvm_model.framework的Resources目录下,但是很上面的make命令生成的tvm_model.framework，却没有包含 readme.md.

参照cmake 打包 ios sdk, 我们可以把 readme.md, 复制到 tvm_model.framework 目录.

版本2

这次，我们用网上推荐的 ios-cmake 来试一下。
ios-cmake 需要cmake-3.14 版本，要下载安装一下。
仿照它的例子，制作编译的 CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.14)

Project (tvm_model C CXX)

# Includes
include_directories(${tvm_model_SOURCE_DIR})

set(RESOURCE_FILES1
readme.md
)


add_library(tvm_model SHARED
         tvm_model_c.cc
         tvm_model_c.hpp
         tvm_model.mm
         tvm_model.h
)
# Debug symbols set in XCode project
set_xcode_property(tvm_model GCC_GENERATE_DEBUGGING_SYMBOLS YES "All")

set(HEADER_FILES1
tvm_model_c.hpp
tvm_model.h
)

set(RESOURCE_FILES1
readme.md
)

set_target_properties(tvm_model PROPERTIES
FRAMEWORK TRUE
FRAMEWORK_VERSION A
MACOSX_FRAMEWORK_IDENTIFIER cn.tvm.tvm_model
# MACOSX_FRAMEWORK_INFO_PLIST Info.plist
# "current version" in semantic format in Mach-O binary file
VERSION 1.0.0
# "compatibility version" in semantic format in Mach-O binary file
SOVERSION 1.0.0
PUBLIC_HEADER "${HEADER_FILES1}"
RESOURCE      "${RESOURCE_FILES1}"
# XCODE_ATTRIBUTE_CODE_SIGN_IDENTITY "iPhone Developer"
)

然后，做一个build.sh,以便能反复编译(只编译模拟器版本)：

#!/bin/bash

[ -d "build" ] && rm -R build/
mkdir build
cd build

cmake .. -G Xcode -DCMAKE_TOOLCHAIN_FILE=../ios.toolchain.cmake -DPLATFORM=SIMULATOR64

cmake --build . --config Debug
cmake --build . --config Release

cd ..

最后，把参考3内的example app复制一份，修改一下，引用我们的tvm_model.framework，就能在模拟器上跑起来了。

参考

• 参考1: cmake 打包 ios sdk
• 参考2: ios使用cmake编译framework
• 参考3: ios-cmake
• 参考4: cmake-3.14
• 参考5: What is the difference between Embedded Binaries and Linked Frameworks
• 参考6：Technical Note TN2435: Embedding Frameworks In An App