用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