제목: [기술] C/C++ 프로젝트에서 Skia C++ ABI 불일치 문제 해결 방법 (rust-skia 활용)

C/C++로 GUI 툴킷이나 그래픽 애플리케이션을 개발 시 Skia 연동 방법을 공유합니다.

Skia C++ ABI(Application Binary Interface) 불일치는 독립적인 C/C++ 프로젝트 연동 시 발생하는 주요 문제입니다.

Skia는 2D 렌더링 라이브러리이나, Makefile이나 CMake 기반의 프로젝트에서 라이브러리로 링크하여 사용하는 데 어려움이 있습니다.

주요 원인은 C++ ABI 불일치입니다.

1. Skia는 gn과 ninja 빌드 시스템을 사용합니다.
2. gn은 빌드 시 C++ 전처리기 플래그(예: -DSK_GANESH, -DSK_GRAPHITE 등)를 정의합니다.
3. DisplayParams.h와 같은 Skia 헤더 파일들은 이 플래그(#ifdef SK_GANESH ...)에 따라 구조체의 메모리 레이아웃(크기)이 동적으로 변경됩니다.
4. C/C++ 프로젝트는 Makefile로 컴파일되므로, gn이 사용한 플래그를 알지 못합니다.
5. 결과: Makefile이 컴파일한 코드(예: DisplayParams 크기 216바이트)와 gn이 빌드한 libskia.a 라이브러리(예: DisplayParams 크기 240바이트) 간에 구조체 크기가 불일치합니다.

이로 인해 Invalid read 오류나 SIGSEGV (메모리 충돌)가 발생하며, Makefile에서의 사용이 제한되었습니다.

rust-skia (Skia의 Rust 바인딩) 프로젝트는 이 ABI 문제를 해결하는 C API 브리지(Bridge)를 구축합니다.

rust-skia는 Rust에서 C++ Skia를 호출하기 위해, 그 중간에 bindings.cpp라는 C API 계층을 두었습니다.

rust-skia의 cargo build 프로세스는 다음과 같이 작동합니다.

1. build.rs 스크립트가 gn과 ninja를 호출하여 C++ Skia 코어(libskia.a)를 빌드합니다.
2. gn이 사용한 모든 C++ 컴파일 플래그를 캡처합니다.
3. bindings.cpp (C API 래퍼)를 2단계에서 캡처한 동일한 플래그로 컴파일합니다.
4. C++ Skia 코어와 C API 래퍼를 하나의 정적 라이브러리(libskia_bindings.a)로 통합합니다.

이 과정을 통해 libskia_bindings.a 라이브러리 내에서 ABI가 일치하는 바이너리가 생성됩니다.

C 툴킷(guiyom)에서의 활용법

rust-skia가 C API 브리지를 제공하므로, C 개발자는 gn이나 ABI 문제를 회피할 수 있습니다.

rust-skia의 Rust 래퍼(skia-safe) 대신, C API 라이브러리 산출물만 선별하여 사용할 수 있습니다.

1. libskia_bindings.a 라이브러리 확보

• 방법 A (사전 빌드된 바이너리 사용): rust-skia/skia-binaries 저장소에서 대상 OS에 맞는 사전 빌드된 바이너리(skia-m142-linux-x86_64.tar.gz 등)를 다운로드합니다.
• 방법 B (FreeBSD/특수 환경): rust-skia 소스 코드를 git clone한 후, cargo build를 실행합니다. (Rust와 ninja, python 필요) 빌드가 완료되면 target/debug/build/skia-bindings-... 폴더에서 libskia_bindings.a 파일을 찾을 수 있습니다.

2. bindings.h 헤더 확보

rust-skia 소스 코드의 skia-bindings/src/bindings.h 파일입니다. (이 파일이 없다면, bindings.cpp의 extern "C" 함수 선언을 기반으로 skia-c.h 헤더를 직접 작성해야 할 수도 있습니다.)

3. Makefile에서 링크

guiyom C 툴킷의 Makefile 구성은 다음과 같이 단순화됩니다.

# skia-binaries에서 가져온 헤더와 라이브러리 경로
SKIA_INC_PATH = -I/path/to/skia_bindings/include
SKIA_LIB_PATH = -L/path/to/skia_bindings/lib

# C 코드는 C++ 헤더가 아닌 C API 헤더를 포함
g-button.o: g-button.c
    gcc -c g-button.c $(SKIA_INC_PATH)

# C++ 플래그 없이, C 라이브러리처럼 링크
guiyom: g-button.o
    gcc g-button.o -o guiyom \
        $(SKIA_LIB_PATH) \
        -lskia_bindings \
        -lfontconfig -lfreetype -lX11 ... (기타 Skia 의존성)

결론

rust-skia 프로젝트를 통해 C/C++ 개발자는 Skia C++ 빌드 시스템의 복잡성을 회피하고, Makefile 기반의 프로젝트에서 Skia를 C API 라이브러리처럼 사용할 수 있습니다.

PS. 러스트 빠돌이에게 말합니다. 러스트 한 언어만 고집하고 한 언어만 사용하는 건 어리석은 짓입니다. 보시다시피 rust-skia 플젝에서도 c/c++ 언어를 사용합니다. c 언어는 현실적으로 대체 불가능해 요. abi 문제 때문에 c는 알아야되고, rust를 사용하더라도 c 언어를 사용하는 경우가 생깁니다. 현명한 사람은 각 실정에 맞게 여러 언어를 사용합니다.