qt_add_ios_ffmpeg_libraries
iOS 앱 번들에 FFmpeg 바이너리를 포함시키는 보조 함수입니다.
이 명령어는 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 이상이 필요합니다.
참고: 이 Qt for iOS 패키지용으로 FFmpeg 백엔드가 빌드되지 않은 경우,이 명령은 아무런 작업도 수행하지 않습니다.
© 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.