iOS C++/Qt应用基于CMake打包带目录结构内置资源的实现方法
iOS平台Qt/C++应用树形结构资源打包指南
项目背景
开发iOS端基于C++/Qt的应用时,需要随安装包携带保留原始目录结构的资源文件。Android端的现有实现逻辑为:预将资源打包为压缩包,在应用启动创建QApplication实例前完成解压操作。
在iOS端的实测过程中发现:
- CMake无法直接按目录树形结构完成资源打包,涉及的配置项包括RESOURCE目标属性、MACOSX_PACKAGE_LOCATION源文件属性
- 暂无法将该限制明确为CMake本身的能力边界,还是iOS平台的通用约束
- 按照Apple官方的Bundle结构设计规则,iOS应用包为节省磁盘空间、简化资源访问流程,默认采用相对扁平的目录结构,不推荐在包内创建额外自定义层级目录
核心待解问题
- 是否存在可直接通过CMake配置完成带树形结构资源打包的落地方案
- 若不存在直接打包方案,如何实现资源预置,保证在QApplication创建前即可正常访问所有资源
现有尝试的踩坑记录
Xcode自定义打包流程适配问题
参考社区方案,将目标资源文件夹加入Xcode工程后,可看到Xcode默认使用的资源打包指令如下:
CpResource _PATH_TO_DIRECTORY_ _APP_BUNDLE_DIRECTORY_/_RESOURCE_DIR_NAME_ cd /Users/denis/opt/qfield/ios/QField export PATH="....." builtin-copy -exclude .DS_Store -exclude CVS -exclude .svn -exclude .git -exclude .hg -strip-debug-symbols -strip-tool /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/strip -resolve-src-symlinks _PATH_TO_DIRECTORY_ _APP_BUNDLE_DIRECTORY_
该流程依赖Xcode专属的builtin-copy命令,目前无法直接通过CMake配置生成对应的打包操作。
直接调用系统cp命令的签名报错问题
参考早期CMake社区的讨论,曾尝试直接在构建流程中调用系统cp命令复制资源文件,该操作在应用签名流程前可正常运行,但到签名阶段会直接报错unsealed contents present in the bundle root。根据Apple官方Bundle结构规则,非本地化资源需要放置在Resources目录的顶层,不支持直接在资源目录下新增自定义子文件夹。
可落地解决方案
CMake直接打包树形结构资源的结论
不存在无需额外配置、仅通过CMake原生属性即可完成树形结构资源打包的通用方案,但可以通过自定义构建命令实现等效效果,且完全符合iOS的签名规则,不会触发bundle结构校验错误。
注意:不要尝试直接把自定义文件夹放到bundle根目录,也不要跳过签名流程的结构校验,否则会导致应用无法在真机安装运行。
资源预置实现流程
- 对齐Android端的实现逻辑,预先将所有需要保留目录结构的资源打包为单个压缩包
- 不再把压缩包内的零散文件逐目录加入CMake的RESOURCE列表,而是将整个预压缩的zip包,通过
MACOSX_PACKAGE_LOCATION Resources属性指定打包到应用包的Resources顶层目录。该操作完全符合Apple对非本地化资源的存放要求——单个zip文件属于顶层Resources目录下的常规非结构化文件,不会被判定为额外的自定义目录,因此不会触发签名时的目录结构校验错误 - 不要把解压后的文件放到应用包内部,需将zip包解压到应用沙盒下的Documents/Caches等可写目录
- 将解压操作的触发时机设置为应用启动入口最早执行的位置,也就是
main()函数中创建QApplication实例之前,保证资源可正常访问 - 针对需要复刻Xcode资源打包流程的场景,可将
builtin-copy替换为macOS系统自带的rsync命令,实现相同的文件拷贝、符号链接解析、排除指定隐藏文件的效果,再通过CMake的add_custom_command绑定到应用目标的构建后阶段。拷贝资源时需保证所有文件落在Resources目录的合规结构范围内,不得在bundle根目录新增自定义层级
内容的提问来源于stack exchange,提问作者Denis Rouzaud
相关产品推荐
相关产品推荐

