이 페이지는 SDK 2.0.0에 해당합니다. Linux와 Windows는
facebetter 네임스페이스의 동일한 C++ API를 공유합니다(facebetter/*.h).요구 사항
Ubuntu / Debian
Fedora / RHEL
1단계: 저장소 클론
2단계: SDK 파일 배치
Linux SDK를demo/cpp/sdk/ 아래에 둡니다.
build/linux/release에 설치됩니다. 위와 같이 include/, lib/libfacebetter.so, resource.fbd를 demo/cpp/sdk/로 복사할 수 있습니다.
3단계: 라이선스 설정
실행 전에app_id / app_key(온라인 v2 인증) 또는 license_token을 설정하세요. license_token이 비어 있지 않으면 우선합니다(라이선스 토큰 문자열, {token} JSON, 또는 오프라인 .lic 내용). 자세한 내용: 인증 및 라이선스.
4단계: 데모 빌드
resource/resource.fbd(및 있는 경우 demo.png)를 build/resource/로 복사합니다.
5단계: 미리보기 이미지 준비 (선택)
6단계: 실행
문제 해결
Q:libfacebetter.so: cannot open shared object fileA:
LD_LIBRARY_PATH=../sdk/lib ./facebetter_demo를 사용하거나, .so를 바이너리 옆으로 복사하거나, ldconfig로 경로를 추가하세요.
Q: 엔진 생성이 nullptr을 반환 / 라이선스 실패A:
resource_path를 resource.fbd로 지정하고, license_token 또는 유효한 app_id + app_key를 설정하세요. 인증 및 라이선스를 참고하세요.
Q: CMake가 OpenGL을 찾지 못함A:
libgl1-mesa-dev(Ubuntu) 또는 mesa-libGL-devel(Fedora)을 설치한 뒤 CMake를 다시 실행하세요.
Q: GLFW: X11: Display variable not setA: 그래픽 세션에서 실행하거나
DISPLAY(X11) / WAYLAND_DISPLAY(Wayland)를 설정하세요.
다음 단계
뷰티 효과 적용
엔진을 만들고 효과를 설정한 뒤 프레임을 처리합니다.
API 레퍼런스
전체 C++ API(Windows와 동일)와 Linux 참고 사항입니다.

