이 페이지에서

macOS에서 소스 코드를 사용하여 FFmpeg 빌드하기

이 페이지에서는 macOS에서 FFmpeg을 설정하고 빌드하는 방법을 설명합니다. 필요한 단계는 다음과 같습니다:

  • FFmpeg 소스 코드를 확보합니다.
  • 필요한 종속성을 설치합니다.
  • 명령줄에서 FFmpeg을 구성합니다.
  • 개발용 라이브러리를 빌드합니다.

FFmpeg 소스 코드 구하기

다음과 같은 방법으로 FFmpeg 소스 코드를 구할 수 있습니다:

  • FFmpeg 다운로드 페이지에서 다운로드합니다.
  • Git에서 클론합니다. 예를 들어, 다음 명령어는 FFmpeg 소스 코드 버전 9.0.1을 ~/ffmpeg 에 클론합니다.
    git clone --branch n9.0.1 https://git.ffmpeg.org/ffmpeg.git ffmpeg

Qt Multimedia 메인 페이지에 명시된 것과 동일한 FFmpeg 버전을 사용하는 것이 좋습니다.

다음 내용에서는 FFmpeg 소스 코드를 ~/ffmpeg 에 저장한 것을 전제로 합니다.

필수 조건

FFmpeg를 빌드하려면 다음 도구와 패키지가 필요합니다:

Homebrew 설치

Homebrew를 설치하려면 다음 명령을 실행하십시오:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Homebrew 패키지 설치

Homebrew 패키지 Yasm을 설치하려면 다음 명령을 실행하세요:

brew install yasm

FFmpeg 구성 및 빌드

~/ffmpeg 디렉터리 내에 build 디렉터리를 생성하고 해당 디렉터리로 이동하십시오:

mkdir ~/ffmpeg/build
cd ~/ffmpeg/build

FFmpeg을 구성하려면 다음 명령을 실행하십시오:

../configure --prefix=/usr/local/ffmpeg --disable-doc --enable-network --enable-shared

--prefix 인수는 빌드 후 FFmpeg 개발 라이브러리가 설치될 경로를 지정합니다. 문서 옵션은 필요하지 않지만, 네트워크 기능은 활성화해야 합니다. FFmpeg를 정적 라이브러리로 빌드하려면 --enable-shared 옵션을 생략하십시오.

앞서 제시된 코드 예제에서는 의도적으로 --prefix 인수에 절대 경로를 사용했습니다. 상대 경로(예: ../install)를 지정하면, 의존성 파일들은 @rpath 을 사용하는 올바른 경로가 아닌 이 상대 경로를 통해 참조됩니다. 절대 경로를 사용하면 FFmpeg 빌드가 비이식적이 됩니다. 상대 경로를 사용하면서 FFmpeg 빌드를 이식 가능하게 만들려면, otool을 사용하여 의존성 경로를 수동으로 수정해야 합니다.

configure 명령어가 완료되면, make 명령어를 사용하여 FFmpeg를 빌드하고 설치하십시오.

make -j install

오류 없이 빌드가 완료되면 FFmpeg 개발 라이브러리가 /usr/local/ffmpeg 디렉터리에 설치됩니다. Qt Multimedia 를 빌드하는 경우, 이 경로는 Qt Multimedia 를 구성할 때 사용되는 FFMPEG_DIR 변수에 저장됩니다.

FFmpeg 범용 바이너리 구성 및 빌드

macOS에서 범용 바이너리(예: x86_64 및 arm64 아키텍처 모두용)를 생성하려면 다음 단계를 따르십시오:

  • arm64 아키텍처용 FFmpeg 구성 및 빌드:
    ../configure --prefix=/usr/local/ffmpeg/arm64 --disable-doc --enable-network \
        --enable-shared --enable-cross-compile --arch=arm64 --cc="clang -arch arm64"
    make -j install
  • x86_64 아키텍처용 FFmpeg 구성 및 빌드:
    ../configure --prefix=/usr/local/ffmpeg/x86_64 --disable-doc --enable-network \
        --enable-shared --enable-cross-compile --arch=x86_64 --cc="clang -arch x86_64"
    make -j install
  • lipo를 사용하여 빌드된 결과를 유니버설 바이너리로 결합합니다.

© 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.