本文内容适合当你想使用 Qt 调用 xcode 开发的动态库 framework 做 iOS 应用的场景，文中涉及到原始动态库 framework 文件的配置，以及 Qt 如何引入和打包动态库 framework 到自身程序中的方法。

动态库 framework 的配置

默认 xcode 创建的 framework 都已经是动态库形式了，所以这里不多介绍，请确保你的 Build Settings 中以下设置是无误的，特别是 Dynamic Library Install Name Base，它决定了动态库能否被应用成功搜索到。 对于 @rpath 的说明，请看这里：https://www.cnblogs.com/csuftzzk/p/mac_run_path.html

Qt 项目配置引入 framework

Qt 引入 framework 只需要给 LIBS 追加 framework 的路径和要链接的文件就可以了，配置如下，请注意使用 framework 参数是 -F 和 -framework（注意大小写）

1
2
LIBS += -F$$PWD/../../build/Products/Release
LIBS += -framework my_dylib.framework

这样引入还是不行的，因为 iOS 应用部署上去以后动态库的 framework 文件是不会跟随打包进去的，所以你还需要做一件事情就是把 framework 打包到你的应用中，配置如下：

1
2
3
MY_DYLIB_FRAMEWORK.files = $$PWD/../../build/Products/Release-iphoneos/my_dylib.framework
MY_DYLIB_FRAMEWORK.path = /Frameworks
QMAKE_BUNDLE_DATA += MY_DYLIB_FRAMEWORK

分别指定了 framework 文件的路径和要被打包进去的目标路径，这里是将 $$PWD/../../build/Products/Release-iphoneos/my_dylib.framework 这个 framework 打包到了应用的 /Framework 目录下。最终你看到的应用目录结构是这样的

1
2
3
4
5
6
7
8
9
10
11
12
13
14
├── Default-568h@2x.png
├── Frameworks
│   └── my_dylib.framework
│       ├── Info.plist
│       ├── ReadMe.txt
│       ├── _CodeSignature
│       │   └── CodeResources
│       └── my_dylib
├── Info.plist
├── LaunchScreen.nib
├── PkgInfo
├── _CodeSignature
│   └── CodeResources
└── cross-platform-demo

可以看到，mu_dylib.framework 文件已经在我们应用的 /Framework 目录下了，这样文件就被打包进去了，而且当你使用 Qt 编译程序的时候，在 Build Shadow 目录下会看到生成对应的 xcodeproj 文件，可以直接使用 xcode 打开，使用 xcode 打开项目后可以看到项目的 Build Phases 下面多了一条 Copy file to bundle 的项目： 但是当你尝试在 iOS 或者模拟机中运行这个应用时你会发现又有新的错误了，如下所示：

1
2
3
4
dyld: Library not loaded: @rpath/my_dylib.framework/my_dylib
  Referenced from: /var/containers/Bundle/Application/D0143CDE-FFFE-4343-BFD9-D70DA66C831F/cross-platform-demo.app/cross-platform-demo
  Reason: image not found
program received signal 6, thread:15362b

我明明已经把文件复制进去了，为什么还是会提示，还记得上面我们提到的 Dynamic Library Install Name Base 吗？这是动态库 framework 设置的，根据上面文章的资料，我们要在调用该模块的应用中设置 rpath 的搜索范围，让其能找到我们的动态库文件。Qt 项目中添加如下配置：

1
2
# 添加应用的 runpath 路径，因为 my_dylib 动态库 Framework 设置的 install path 为 rpath，所以应用使用时需要单独设置
QMAKE_LFLAGS += -Wl,-rpath,@loader_path/Frameworks

如此设置后，在 Qt 中就可以成功编译程序并运行在模拟器或真机上了，如果还有任何疑问欢迎留言我们一起讨论。