macOS 환경에서 ThorVG 빌드 및 예제 구동 환경 셋업 가이드

ThorVG 환경을 로컬에 세팅하는 전체 과정을 정리했습니다. 셋업하며 발생한 에러(OpenMP, pkg-config 문제 등) 해결법도 함께 적어두었으니 동일한 오류가 발생하시는 분들은 참고하면 좋을 거 같습니다.

1. 필수 환경 및 빌드 도구 설치

ThorVG는 빌드 시스템으로 Meson과 Ninja를 사용합니다. 화면에 창을 띄워 그래픽을 렌더링하기 위한 SDL2와, 패키지 의존성을 관리하는 pkg-config 도구가 추가로 필요합니다.

macOS 환경에서는 Homebrew를 이용해 설치할 수 있습니다. 터미널을 열고 아래 명령어들을 입력합니다.

brew install git meson ninja
brew install sdl2
brew install pkg-config

2. ThorVG 메인 엔진 클론 및 빌드

2.1. 레포지토리 클론 및 이동

터미널에서 작업할 디렉토리로 이동한 뒤, GitHub에서 ThorVG 코드를 가져옵니다.

git clone https://github.com/thorvg/thorvg.git
cd thorvg

2.2. 빌드 환경 설정 및 컴파일 (Ninja)

Meson으로 빌드 폴더를 세팅하고 컴파일을 진행합니다.

meson setup builddir
ninja -C builddir

에러 발생: fatal error: 'omp.h' file not found 발생한다면? macOS의 기본 C++ 컴파일러(Apple Clang)에 OpenMP가 내장되어 있지 않아 발생하는 에러입니다. 해결법은 아래와 같습니다.

rm -rf builddir
meson setup builddir
ninja -C builddir

3. 로컬 시스템에 ThorVG 엔진 설치

빌드가 100% 완료되었다면, Mac 시스템이 인식할 수 있도록 경로에 설치가 필요합니다. 이 과정을 건너뛰면 나중에 예제 빌드할 때 Dependency "thorvg-1" not found 에러가 발생합니다.

sudo ninja -C builddir install

4. 예제 프로젝트 셋업 및 구동

4.1. 예제 레포지토리 클론

현재 메인 thorvg 폴더에서 상위 폴더로 빠져나온 뒤, 예제 레포지토리를 가져옵니다.

cd ..
git clone https://github.com/thorvg/thorvg.example.git
cd thorvg.example

4.2. 예제 프로젝트 빌드

meson setup builddir
ninja -C builddir

4.3. 예제 실행

애니메이션 예제를 구동해보겠습니다.

./builddir/src/Animation

화면에 애니메이션 그래픽을 담은 창이 정상적으로 팝업되는 것을 확인할 수 있습니다.