워치 페이스 형식

시계 화면은 사용자가 시계를 볼 때 가장 먼저 보게 되는 항목이므로 Wear OS에서 가장 자주 사용되는 노출 영역입니다. 사용자는 시계 화면을 사용하여 시계를 자신의 스타일에 맞게 맞춤설정하고 한눈에 빠르게 정보를 제공합니다.

대상

새로운 워치 페이스 형식 (WFF)을 사용하면 그 어느 때보다 쉽게 시계 화면을 빌드할 수 있습니다. Google은 삼성과 협력하여 시계 화면을 직접 디자인할 수 있는 WYSIWYG 스타일 도구인 시계 화면 스튜디오를 출시했습니다.

시계 구성을 수동으로 관리하려면 XML을 사용하여 시계 화면을 정의할 수도 있습니다. 이 가이드는 XML을 사용하거나 워치 페이스 형식을 사용하여 시계 화면을 만들기 위한 맞춤 도구를 빌드하는 개발자를 대상으로 합니다. Android 스튜디오에는 워치 페이스 형식을 사용하는 시계 화면을 빌드하고 실행하는 지원도 포함되어 있습니다.

삼성과 협력하여 만든 워치 페이스 형식은 시계 화면의 모양과 동작을 구성하는 선언적 XML 형식입니다. APK에 시계 화면을 렌더링하는 코드가 포함되어야 하는 다른 시계 화면 API와 달리 워치 페이스 형식에는 리소스와 선언적 안내만 필요합니다. Wear OS 플랫폼은 시계 화면을 렌더링하는 데 필요한 로직을 처리하므로 개발자는 코드 최적화나 배터리 성능보다는 창의적인 아이디어에 집중할 수 있습니다.

이 새로운 형식으로 빌드된 시계 화면은 기존 Jetpack 시계 화면 라이브러리를 사용하여 빌드된 시계 화면보다 유지관리가 쉽고 업데이트가 적습니다. 예를 들어 성능이나 배터리 소모의 개선사항을 적용하거나 최신 버그 수정을 받기 위해 시계 화면을 업데이트할 필요가 없습니다.

형식 정보

워치 페이스 형식 (WFF) 시계 화면의 핵심은 시계 화면의 레이아웃과 동작을 정의하는 문서입니다. 이 문서는 WFF 사양을 준수하는 XML로 작성되었습니다.

Wear OS 시스템에는 시계 화면 렌더러 구성요소가 포함되어 있습니다. 이 구성요소는 WFF XML 문서를 파싱하고 이를 사용하여 시계 화면을 렌더링합니다. 이미지 및 글꼴과 같은 기타 리소스는 필요에 따라 가져옵니다.

이 접근 방식을 사용하면 시계 화면이 어떻게 표시되어야 하는지 설명하는 데만 시간을 들이면 되며 Wear OS에서 시계 화면을 그리는 모든 코드를 처리합니다.

워치 페이스 형식 시계 화면을 기기에 배포하려면 XML 문서를 표준 AAB 또는 APK 패키지로 패키징합니다.

다음 다이어그램은 이 접근 방식의 개요를 보여줍니다.

Wear OS 시스템이 워치 페이스 형식 XML 문서에서 시계 화면을 렌더링하는 방법

WFF의 버전 관리

WFF가 발전함에 따라 형식의 새 요소, 속성, 데이터 소스 등으로 표현되는 새로운 기능이 추가됩니다.

예를 들어 WFF 버전 2에서는 WFF 버전 1에서는 사용할 수 없는 날씨 지원을 데이터 소스로 도입했습니다.

시계 화면을 설계할 때는 사용할 기능과 버전 사용 가능 여부를 확인하세요. 참조 가이드에는 모든 기능과 사용 가능 여부가 표시됩니다.

WFF의 각 버전은 Wear OS 출시와 일치합니다.

WFF 버전 최소 Wear OS 버전 최소 API 수준
1 4 33
2 5 34
3 5.1 35
4 6 36

AndroidManifest.xml 및 Gradle 빌드 파일을 적절하게 구성하려면 이 가이드를 참고하세요.

자세히 알아보기

다음 가이드에서 워치 페이스 형식에 관해 자세히 알아보세요.

  • 사용 가능한 기능: 워치 페이스 형식의 각 버전에서 지원하는 워치 페이스 기능을 살펴봅니다.
  • 디자인 가이드라인: 시계 화면의 레이아웃 및 사용자 환경 관련 권장사항을 알아봅니다.
  • 설정: 워치 페이스 형식을 지원하는 Android App Bundle을 구성합니다.
  • GitHub 샘플: 샘플 시계 화면을 빌드하고 Wear OS 에뮬레이터 또는 실제 기기에 배포합니다.
  • 메모리 사용량 최적화: 시계 화면을 렌더링할 때 시스템이 메모리를 최대한 적게 사용하도록 시계 화면을 구성하는 방법을 알아봅니다.
  • XML 참조: 워치 페이스 형식 파일의 일부인 개별 요소를 살펴봅니다. 루트 요소는 항상 WatchFace입니다. 참고: XML 참조에서 특정 워치 페이스 형식 버전의 기능을 보려면 문서 페이지 상단에서 적절한 버전 버튼이 선택되어 있는지 확인합니다.
  • 게시 가이드: Play 스토어 및 대체 방법을 통해 시계 화면을 게시하고 수익을 창출하는 방법을 알아봅니다.
  • WFF 및 메모리 검사기: 이 오픈소스 도구를 사용하여 시계 화면 형식 파일의 오류를 확인하고 Google Play에 제출하기 전에 허용 가능한 메모리 사용량을 확인합니다.