Filament 1.78.1, tvOS용 Metal 빌드 경로 추가

tvOS용 Metal 빌드 경로가 추가됐습니다

Filament 1.78.1은 한국시간 2026년 10월 22일 공개됐습니다. Apple TV 기기와 tvOS 시뮬레이터용 빌드를 지원하며, 이 경로는 Metal 전용입니다. 새 플랫폼으로 앱을 옮길 출발점이 생긴 것이지, 모든 기존 앱의 포팅이나 성능 검증이 끝났다는 발표는 아닙니다.

릴리스와 같은 v1.78.1 태그의 BUILDING.md를 함께 확인했습니다. 문서는 iOS와 같은 도구 체인 경로를 사용하고 OpenGL 백엔드를 자동으로 비활성화한다고 설명합니다. 따라서 다른 플랫폼의 그래픽 설정을 그대로 복사하기 전에 tvOS에서 실제 선택되는 백엔드를 확인해야 합니다.

기기와 시뮬레이터를 묶어 만듭니다

공식 빌드 예시는 다음과 같습니다. 이 글에서 실행한 명령이 아니라 문서에 있는 재현용 절차입니다.

./build.sh -i -s -p tvos release

-s를 빼면 시뮬레이터 슬라이스를 생략하고, -a를 추가하면 배포용 압축 파일을 만듭니다. 결과는 out/tvos-release/filament 아래에 설치되며 라이브러리별 XCFramework에 기기용 arm64와 시뮬레이터용 arm64가 들어갑니다. 빌드 스크립트에서도 두 대상 경로를 구분해 호출하는 것을 확인했습니다.

시뮬레이터의 기능이 실기기와 같지는 않습니다

이 태그의 문서는 최소 배포 버전을 tvOS 17.0으로 명시합니다. 또한 시뮬레이터가 Apple TV HD에 해당하는 Metal GPU 계열을 알리므로 비교 샘플러가 필요한 PCF 그림자 같은 기능을 사용할 수 없다고 설명합니다. Apple TV 4K에서는 해당 기능을 사용할 수 있다는 안내와 구분해서 읽어야 합니다.

즉 시뮬레이터에서 그림자가 보이지 않는 상황을 곧바로 모든 Apple TV의 지원 부족으로 해석해서는 안 됩니다. 반대로 시뮬레이터에서 앱이 실행됐다는 사실만으로 실제 장치의 화질과 프레임 시간을 검증했다고 할 수도 없습니다.

포팅 검토에서 남길 기록

처음에는 작은 장면으로 재질과 텍스처가 실제 장치에 표시되는지 확인하고, 이후 사용하는 그림자와 후처리를 하나씩 추가해 보세요. 빌드 성공, 앱 시작, 렌더링 기능, 성능은 서로 다른 확인 단계입니다. 기기 모델과 운영체제, 선택한 빌드 슬라이스를 함께 기록하면 문제를 분류하기 쉽습니다.

공식 자료는 빌드 지원과 알려진 기능 차이를 설명하지만 프로젝트별 호환성을 보장하지 않습니다. 이 글은 해당 태그의 문서와 스크립트를 대조한 정리이며, Apple TV에서 직접 실행하거나 성능을 측정한 결과는 아닙니다.

출처

• Filament 1.78.1 릴리스
• v1.78.1 BUILDING.md · tvOS 조건
• v1.78.1 빌드 스크립트