· Woohyun Kim · Platform Engineering

WFF XML 스키마 설계 회고

WFF 명세의 XSD 설계·구현 과정과 주요 설계 근거를 설명합니다. 요소·속성·타입의 구성, 작성 규칙, 검증 범위를 통해 XSD 적용의 장점과 한계를 정리합니다.

WFF(Watch Face Format)는 Wear OS에서 워치페이스의 외형과 동작을 XML로 기술하는 선언형 포맷입니다. 제작자가 렌더링 요소와 동작을 선언하면 Wear OS의 렌더러가 이를 해석해 워치페이스를 렌더링합니다. 구글과 삼성이 협력해 개발한 포맷으로, Android 공식 문서에서 그 구조와 사용 방식을 살펴볼 수 있습니다.

삼성에서 저는 기존 워치페이스의 XML 구조 분석과 XSD(XML Schema Definition) 설계·구현을 담당했습니다. 주요 설계 항목은 요소·속성·타입의 구성, 스키마의 제약 조건, 개발 과정에서의 스키마 활용 방식이었습니다.

이 시리즈에서는 WFF 초기 명세의 설계·구현 과정과 그 근거를 설명합니다. 공개 코드에서 확인할 수 있는 요소·속성·타입의 정의에 당시의 설계 의도와 판단 근거를 보충하고, XML 명세에 XSD를 적용할 때의 장점과 한계를 정리합니다.

Tizen에서 Wear OS로

Tizen 시절의 삼성 워치페이스도 XML 기반의 선언형 포맷을 사용했습니다. XML에 렌더링 요소와 동작을 기술하면 Runtime이 이를 해석하는 방식이었습니다.

당시 제작 도구였던 GWD(Galaxy Watch Designer)는 이후 Galaxy Watch Studio로 이름이 바뀌었습니다. 삼성 워치가 Wear OS를 채택하면서 Wear OS용 워치페이스 제작 도구인 WFS(Watch Face Studio)를 개발했습니다.

이 개발은 삼성 워치의 플랫폼 전환에 맞춰 제작 도구와 워치페이스 구조를 재정립하는 작업으로 시작했습니다. 처음부터 안드로이드의 표준 포맷을 만들겠다는 목표를 세운 것은 아니었습니다.

Wear OS를 개발하던 구글과의 정기 미팅에서 이 프로젝트가 소개됐습니다. 구글의 긍정적인 검토 이후 개발팀 간 협업이 진행됐습니다.

당시 제가 참여한 워치페이스 프로젝트는 삼성이 개발을 주도하고 실제 구현을 담당했습니다. 구글과는 차기 워치페이스 표준 버전에 포함할 기능과 확장 방향을 주로 논의했으며, 코드 수준에서는 삼성이 구현한 내용을 구글이 전달받아 리뷰하는 방식으로 협업했습니다.

이후 워치페이스 포맷과 함께 이를 로드해 렌더링과 기능 실행을 담당하는 Watch Face Runtime도 안드로이드 플랫폼에 채택·통합됐습니다. 초기 개발 과정에서 DWF(Declarative Watch Face)라고 부르던 포맷은 이 과정에서 WFF로 정식 명칭이 변경됐습니다.

XML과 XSD를 선택한 이유

플랫폼 전환 과정에서 기존 XML 명세를 검토했습니다. 명세는 담당자들이 내부 위키에 텍스트로 작성·관리하고 있었으며, 해석과 유지보수에는 담당자의 지식에 의존하는 부분이 있었습니다. 이를 개선하기 위해 요소와 속성, 데이터 타입, 구성 관계를 기계가 해석·검증할 수 있는 스키마로 정의하고자 했습니다.

  1. 기존 워치페이스 자산 재사용

    XML을 유지한 중요한 이유는 GWD에서 구축한 워치페이스 생태계를 이어가기 위해서였습니다. 삼성 워치가 Wear OS로 전환하더라도, 기존 Tizen 워치페이스의 제작 자산과 XML 기반 구조를 재사용할 수 있다고 판단했습니다. 다만 기존 포맷과 새 포맷 사이에는 차이가 있었으므로, 팀 내 선배가 Tizen 워치페이스를 Wear OS용으로 자동 변환하는 유틸리티를 개발했고 이를 배포했습니다. Galaxy Watch Studio Converter의 공식 안내에서도 이러한 전환 도구를 확인할 수 있습니다.

  2. Scene graph를 표현하는 선언형 구조

    또한 XML의 요소 트리는 렌더링 scene graph의 계층을 표현하기에 적합했습니다. 부모·자식 관계로 구성되는 렌더링 노드를 XML 요소의 중첩으로 기술할 수 있었고, 기존 포맷의 선언형 모델도 유지할 수 있었습니다. scene을 순회할 때는 XML 인스턴스에 선언된 순서대로 렌더링 요소를 그리도록 했습니다. 제작자는 요소의 중첩과 선언 순서로 렌더링 구성을 파악할 수 있었습니다. Android의 렌더링 설명에서도 이 순회 모델을 확인할 수 있습니다.

  3. 표준 검증 도구 활용

    XSD에 요소·속성·타입과 구성 제약을 정의하면, 표준 validator로 개별 워치페이스 XML의 스키마 적합성을 검사할 수 있습니다. 명세를 검증에 직접 활용하면 개발 품질을 높이고 장기적인 검증 비용을 줄이는 데 유리하다고 판단했습니다. 이를 위해 스키마 구조와 함께 XSD로 표현할 수 있는 검증 규칙의 범위도 검토했습니다.

  4. 향후 JSON Schema 전환 가능성

    XSD를 선정하던 당시에는 JSON Schema도 함께 검토했습니다. 검토 과정에서 XSD를 JSON Schema로 변환하는 라이브러리를 찾을 수 있었습니다. 이에 XSD로 출발하더라도 향후 JSON 기반 포맷이 필요해지면 기존 명세를 재사용할 수 있어, 전환 부담이 크지 않을 것으로 판단했습니다.

팀 내 설계 검토와 XSD 구현

기존 XML 포맷의 구조 개선 방안을 팀 내에서 주기적으로 논의했습니다. 저는 논의한 내용을 바탕으로 선언형 모델을 XSD의 요소·속성·타입으로 구현했습니다.

XSD의 설계 및 구현을 담당하게 되면서 팀 내에서 문법과 정의 방식을 함께 검토할 필요도 있었습니다. 학습하며 정리한 XSD의 개념과 설계 철학, 표현 방식과 한계를 세미나에서 공유했습니다. 워치페이스의 요소·속성·타입을 실제로 어떻게 정의했는지 설명하고, 일관되고 명확한 명세를 작성하기 위한 coding convention 등을 다루었습니다.

구체적인 설계와 구현은 이어지는 글에서 설명합니다.

제작·배포 과정에서의 활용

XSD 명세와 함께, 워치페이스 XML을 입력받아 스키마 적합성을 검사하는 Validator도 개발했습니다. Google Play에서는 워치페이스 업로드 과정에서 포맷 유효성을 검증하며, 해당 Validator도 이 검증 시스템에 통합됐습니다. 검증기는 현재 Google의 공식 저장소와 배포 패키지로 공개·배포되고 있습니다.

회고

협업 이력과 참조 자료

삼성과 구글의 보안 규약과 시스템적 제약으로 인해, 동료들의 변경 이력이 두 회사의 저장소 간에 연속적으로 유지되지는 못했습니다. 설계와 구현의 변경 과정을 커밋 이력으로 추적하기 어렵다는 점은 협업 과정에서 아쉬웠던 부분입니다.

공개 코드만으로는 현재 구조를 확인할 수 있지만, 그 구조를 선택한 이유와 검토 과정을 파악하기는 어렵습니다. 이처럼 커밋 이력으로 충분히 전달되지 않는 설계 의도와 판단 근거를 보충하기 위해 이 시리즈를 작성합니다.

당시 작업은 삼성 내부의 sec.github와 ecode에서 관리됐습니다. 이 글은 당시의 수행 경험과 기억을 바탕으로 공개 가능한 범위에서 작성하며, 코드 설명에는 공개 WFF XSD를 참조합니다.

코드 설명은 Adds WFF XML validator 커밋에 포함된 버전 1을 기준으로 합니다.

Watch Face Runtime의 렌더러 선택

Watch Face Runtime은 워치페이스 XML을 읽고, 선언된 요소를 렌더링하며 동작을 실행하는 모듈입니다. 당시 런타임 렌더러는 Android View 기반으로 구현했습니다.

성능이 중요한 워치 기기의 특성을 고려하면, OpenGL ES(GLES)나 Vulkan 같은 저수준 그래픽 API로 렌더러를 직접 구현하는 방식이 이상적이라고 판단했습니다. 실제 구현 방식을 결정할 때는 팀의 그래픽스 전문성과 프로젝트의 유지보수 부담도 함께 고려해야 했습니다. 모든 Runtime 개발자가 그래픽스 전문성을 높여야 하는 부담이 있었으며, 규모가 큰 Runtime 프로젝트에서 저수준 렌더러까지 직접 관리하는 데에는 상당한 개발·유지보수 비용이 필요할 것이었습니다.

이러한 조건에서 Android View 기반으로 요구사항을 충족할 수 있는지 검토했습니다. 렌더링 부하가 큰 워치페이스에서는 성능 문제가 발생할 수 있다고 예상했지만, 일반적인 워치페이스 구성은 목표 성능 수준을 충족할 것으로 판단했습니다. 이에 요구 성능과 팀의 개발·유지보수 여건을 함께 고려해 View 기반의 렌더링 구현 방식을 채택했습니다.

View 기반 Runtime에서 WFF의 렌더링 기능을 확장하려면 View 계층에서 제공하는 기능과 제어 범위 안에서 구현해야 합니다. 예를 들어 glow·blur·reflection·distortion 등과 같은 효과는 간단한 쉐이딩으로 구현 가능하지만, 초기 검토 당시 View 기반 방식에서는 RuntimeShader 및 RenderEffect를 활용하더라도 멀티패스 구성과 버퍼 크기를 직접 제어할 수 없는 등의 한계가 있었습니다. 결국 Runtime의 구현 제약이 WFF가 지원할 수 있는 디자인과 기능의 범위까지 제한할 수 있다는 점이 한계점이었습니다.

안드로이드 표준에 정식으로 탑재된 지금 돌이켜보면, 워치 기기의 성능뿐 아니라 표준 자체의 확장성을 위해서도 장기적으로 View 의존성에서 벗어날 필요가 있다고 생각합니다.

이어지는 글

구체적인 설계 내용은 다음 세 편으로 나누어 설명합니다.

이 경험이 XML 명세에 XSD를 활용하려는 개발자들에게, 적용 가능성과 장단점을 검토하고 선택하는 데 도움이 되기를 바랍니다.


참고자료 — XSD에서 JSON Schema를 생성하는 도구 예시: xsd2jsonschema, Jsonix Schema Compiler의 JSON Schema 생성 기능.

  • Wear OS
  • WFF
  • XML
  • XSD
  • Schema Design
Share:
블로그로 돌아가기