Windows에서 소스에서 FFmpeg 빌드하기
이 페이지에서는 Windows에서 FFmpeg를 구성하고 빌드하는 방법을 설명합니다. 여기에는 다음이 포함됩니다:
- FFmpeg 소스 코드를 가져옵니다.
- 필요한 종속성을 설치합니다.
- 명령줄에서 MSVC 또는 MinGW-w64용 FFmpeg를 구성합니다.
- 개발 라이브러리를 빌드합니다.
FFmpeg 소스 코드 가져오기
다음과 같은 방법으로 FFmpeg 소스 코드를 얻을 수 있습니다:
- FFmpeg 다운로드 페이지에서 다운로드합니다.
- git에서 복제. 예를 들어, 이 명령은 FFmpeg 소스 버전 7.1을
C:\FFmpeg\ffmpeg
에 복제합니다.C:\FFmpeg> git clone --branch n7.1 https://git.ffmpeg.org/ffmpeg.git ffmpeg
Qt Multimedia 메인 페이지에 설명된 것과 동일한 FFmpeg 버전을 사용하는 것이 좋습니다.
다음 단락에서는 FFmpeg 소스 코드를 C:\FFmpeg\ffmpeg
에 저장한다고 가정합니다.
전제 조건
FFmpeg를 빌드하려면 다음 도구와 패키지가 필요합니다:
- 마이크로소프트 비주얼 스튜디오 컴파일러(MSVC) 또는 MinGW-w64.
- MSYS2.
- MSYS 패키지(perl, make, yasm, diffutils).
Qt에서 지원하는 권장 컴파일러는 윈도우용 Qt - 소스에서 빌드를 참조하십시오. 지원되는 MinGW-w64 컴파일러는 Qt Online Installer 를 사용하여 설치할 수 있습니다.
MSYS2 설치하기
MSYS2를 설치하려면 다음과 같이 할 수 있습니다:
- MSYS2 인스톨러를 사용합니다.
- winget 패키지 관리자를 사용합니다.
winget install msys2.msys2
이 문서의 지침은 winget
을 사용할 때 기본 경로인 C:\msys64\
에 설치된 MSYS2 를 기준으로 합니다.
설치가 완료되면 Windows 시작 메뉴에서 MSYS2 MINGW64
셸을 시작하고 이를 사용하여 필요한 라이브러리를 설치합니다.
pacman -S --noconfirm perl make yasm diffutils
FFmpeg를 빌드하기 전에 MSYS2의 PATH
에 컴파일러가 있어야 합니다. 이 과정은 MSVC와 MinGW-w64의 경우 다르게 수행됩니다. 사용하는 컴파일러에 맞게 MSYS2 환경을 준비합니다.
Mingw-w64로 빌드하기 위한 MSYS 환경 준비하기
MinGW-w64를 C:\Qt\Tools\mingw1310_64\bin
에 설치한 경우 PATH 환경 변수를 내보내 PATH
에 추가할 수 있습니다.
$ export PATH=/c/Qt/Tools/mingw1310_64/bin:$PATH
pacman을 사용하여 MinGW-w64를 설치할 수도 있습니다.
$ pacman -S mingw-w64-x86_64-toolchain
MSVC를 위한 MSYS2 환경 준비하기
MSYS2에서 MSVC 컴파일러로 FFmpeg를 빌드하려면 경로에 적절한 C 및 C++ 컴파일러를 사용하여 MSYS2를 시작해야 합니다. 64비트 빌드의 경우 다음과 같이 할 수 있습니다:
- Windows 시작 메뉴에서 Visual Studio x64 네이티브 도구 명령 프롬프트를 시작합니다.
- 기존 명령 프롬프트에서 다음을 실행하여 MSVC 컴파일러를 활성화합니다:
"C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
이 명령 프롬프트에서 MINGW64 환경을 선택하고 경로 상속을 활성화하는 옵션이 있는 MSYS2 셸을 실행합니다.
C:\msys64\msys2_shell.cmd -mingw64 -full-path
그러면 새 셸 창이 실행되어 MSVC 컴파일러를 사용할 수 있는지 확인할 수 있습니다.
$ which cl.exe
FFmpeg 구성 및 빌드
준비된 MSYS2 셸에서 /c/FFmpeg
디렉토리로 이동합니다. 이 디렉터리에서 FFmpeg 빌드 아티팩트를 포함할 build
디렉터리를 생성하고 해당 디렉토리로 이동합니다.
$ cd /c/FFmpeg/build
MinGW-w64로 빌드하기 위해 FFmpeg를 구성하려면 실행합니다:
$ ../ffmpeg/configure --prefix=../install --disable-doc --enable-network --enable-shared
MSVC로 빌드하도록 FFmpeg를 구성하려면 다른 명령줄 옵션과 함께 툴체인을 지정합니다:
$ ../ffmpeg/configure --prefix=../install --disable-doc --enable-network --enable-shared --toolchain=msvc
--prefix
인수는 빌드 후 FFmpeg 개발 라이브러리가 설치되는 경로를 지정합니다. 설명서는 필요하지 않지만 네트워크 기능이 활성화되어 있어야 합니다. FFmpeg를 정적 라이브러리로 빌드하려면 --enable-shared
옵션을 생략하세요.
configure
명령이 완료되면 make
명령을 사용하여 FFmpeg를 빌드하고 설치합니다.
$ make -j install
오류 없이 빌드가 완료되면 C:\FFmpeg\install
디렉토리에 FFmpeg 개발 라이브러리가 설치됩니다. Qt Multimedia 을 빌드하는 경우 이 경로는 Qt Multimedia 을 구성할 때 사용되는 FFMPEG_DIR
변수에 저장됩니다.
© 2025 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.