qt_add_ios_ffmpeg_libraries
用于将 FFmpeg 二进制文件嵌入 iOS 应用包的辅助函数。
该命令定义在Qt6 包的Multimedia 组件中,可按以下方式加载:
find_package(Qt6 REQUIRED COMPONENTS Multimedia)该命令于 Qt 6.8 版本中引入。
注意:该 命令处于技术预览阶段,未来版本中可能会发生变更。
语法
qt_add_ios_ffmpeg_libraries(target)如果禁用了无版本号的命令,请改用qt6_add_ios_ffmpeg_libraries() 。它支持与本命令相同的参数集。
说明
必须将在线安装程序中的 FFmpeg 二进制文件嵌入到应用程序的包中。要嵌入 FFmpeg 二进制文件,您可以在项目中的 CMakeLists.txt 文件内,向可执行目标添加qt_add_ios_ffmpeg_libraries 命令。
该函数必须在可执行目标上调用。它不能用于库目标或接口目标。如果您的项目是一个链接到Qt Multimedia 的库,则将其链接进去的可执行文件必须调用此函数。
该命令将为应用程序目标设置以下属性:
- XCODE_EMBED_FRAMEWORKS:为 XCode 添加信息(指定要嵌入的 FFmpeg 二进制文件)。
- XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY 设置为 ON,以便对嵌入的 FFmpeg 二进制文件进行代码签名。
- XCODE_ATTRIBUTE_LD_RUNPATH_SEARCH_PATHS——用于在软件包中添加嵌入式 FFmpeg 库的位置。
如果不需要代码签名,可以在命令 `qt_add_ios_ffmpeg_libraries` 之前使用变量 `QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY`:
set(QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY ON)注意: qt_add_ios_ffmpeg_libraries 需要 CMake 3.28 或更高版本。
注意: 如果 FFmpeg 后端未针对此 Qt for iOS 软件包进行构建,则此 命令将无效果。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.