시계 화면은 사용자가 시계를 볼 때 가장 먼저 보게 되는 항목이므로 Wear OS에서 가장 자주 사용되는 노출 영역입니다. 사용자는 시계 화면을 사용하여 시계를 자신의 스타일과 필요에 맞게 맞춤설정하고 한눈에 정보를 확인할 수 있습니다.
시계 화면 만들기 옵션
워치 페이스 형식 (WFF)을 사용하면 그 어느 때보다 쉽게 시계 화면을 빌드할 수 있습니다.
삼성과 협력하여 만든 워치 페이스 형식은 시계 화면의 모양과 동작을 구성하는 선언적 XML 형식입니다. APK에 시계 화면을 렌더링하는 코드를 포함해야 하는 다른 시계 화면 API와 달리 워치 페이스 형식에는 리소스와 선언적 명령만 필요합니다. Wear OS 플랫폼은 시계 화면을 렌더링하는 데 필요한 로직을 처리하므로 개발자는 코드 최적화나 배터리 성능보다는 창의적인 아이디어에 집중할 수 있습니다.
시계 화면을 만드는 방법은 여러 가지가 있습니다.
워치 페이스를 직접 디자인할 수 있는 WYSIWYG 스타일 도구를 선호한다면 삼성과 협력하여 지원하는 워치 페이스 스튜디오를 사용하세요.
디자이너로서 Figma를 사용하는 데 익숙하거나 개발자로서 시계 화면을 만드는 처음 몇 단계를 빠르게 진행하고 싶다면 Figma 내에서 플러그인을 사용하여 액세스하는 워치 페이스 디자이너를 사용하세요.
시계 구성을 수동으로 관리하고 자체 앱 스토어에 게시하려면 XML을 사용하여 시계 화면을 정의한 다음 시계 화면 푸시를 사용하여 게시하면 됩니다.
Android 스튜디오에는 워치 페이스 형식을 사용하는 시계 화면을 빌드하고 실행하는 기능도 포함되어 있습니다.
이 형식으로 빌드된 시계 화면은 기존 Jetpack 시계 화면 라이브러리를 사용하여 빌드된 시계 화면보다 유지관리가 쉽고 업데이트가 적습니다. 예를 들어 성능이나 배터리 소모의 개선사항을 적용하거나 최신 버그 수정을 받기 위해 시계 화면을 업데이트할 필요가 없습니다.
형식 정보
워치 페이스 형식 (WFF) 시계 화면의 핵심은 시계 화면의 레이아웃과 동작을 정의하는 문서입니다. 이 문서는 WFF 사양을 준수하는 XML로 작성됩니다.
Wear OS 시스템에는 시계 화면 렌더러 구성요소가 포함되어 있습니다. 이 구성요소는 WFF XML 문서를 파싱하고 여기에서 워치 페이스를 렌더링합니다. 이미지, 글꼴과 같은 다른 리소스는 필요에 따라 가져옵니다.
이 방식을 사용하면 시계 모드의 모양을 설명하는 데만 시간을 할애하면 되고 Wear OS에서 시계 모드를 그리는 모든 코드를 처리합니다.
워치 페이스 형식 시계 화면을 기기에 배포하려면 표준 AAB 또는 APK 패키지에 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 빌드 파일을 적절하게 구성하려면 이 가이드를 참고하세요.
자세히 알아보기
다음 가이드에서 워치 페이스 형식에 관해 자세히 알아보세요.
사용 가능한 기능: 각 버전의 워치 페이스 형식에서 지원하는 워치 페이스 기능을 살펴봅니다.
GitHub 샘플: 샘플 시계 화면을 빌드하고 Wear OS 에뮬레이터 또는 실제 기기에 배포하여 시작합니다.
메모리 사용량 최적화: 시계 화면을 렌더링할 때 시스템이 메모리를 최대한 적게 사용하도록 시계 화면을 구성하는 방법을 알아봅니다.
XML 참조: 워치 페이스 형식 파일의 일부인 개별 요소를 살펴봅니다. 루트 요소는 항상 WatchFace입니다. 참고: XML 참조에서 특정 워치 페이스 형식 버전의 기능을 보려면 문서 페이지 상단에서 적절한 버전 버튼이 선택되어 있는지 확인하세요.
게시 가이드: Play 스토어와 대체 방법을 통해 시계 화면을 게시하고 수익을 창출하는 방법을 알아봅니다.
WFF 및 메모리 검사기: 이러한 오픈소스 도구를 사용하여 워치 페이스 형식 파일에 오류가 있는지 확인하고 Google Play에 제출하기 전에 허용되는 메모리 사용량을 확인합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-27(UTC)"],[],[],null,["**Note:** The [Watch Face Format](/training/wearables/wff) is\nrequired for watch faces to be installed on devices with Wear OS 5 or later\npre-installed and for all new watch faces published on Google Play.\n\nStarting in January 2026, the Watch Face Format will be required for watch\nfaces to be installed on all Wear OS devices.\n\nLearn more about the user-facing changes in this\n[Help Center\narticle](https://support.google.com/wearos/thread/284572445). \n\nA watch face is the first thing a user sees when they look at their watch,\nmaking it the most frequently used surface of Wear OS. Users rely on watch faces\nto customize their watches to suit their style and provide quick information at\na glance.\n\nOptions for creating watch faces\n\nThe Watch Face format (WFF) makes it easier than ever to build a watch face.\nCreated in partnership with Samsung, the Watch Face Format is a declarative XML\nformat to configure the appearance and behavior of watch faces. Unlike other\nwatch face APIs, where your APK must include the code to render the watch face,\nthe Watch Face Format only requires resources and declarative instructions. The\nWear OS platform handles the logic needed to render the watch face so you can\nfocus on your creative ideas, rather than code optimizations or battery\nperformance.\n\nWe provide several ways to create a watch face:\n\n- If you prefer a What-You-See-Is-What-You-Get style tool that lets you design the watch face directly, use [Watch Face Studio](https://developer.samsung.com/watch-face-studio/overview.html), which we support in partnership with Samsung.\n- If you're comfortable using [Figma](https://www.figma.com/design/) as a designer, or if you're looking to accelerate the first few steps of creating a watch face as a developer, use [Watch Face Designer](/training/wearables/watch-face-designer), which you access using a plug-in within Figma.\n- If you prefer to manage your watch configuration manually and publish to\n your own app store, you can define watch faces using XML, then publish using\n [Watch Face Push](/training/wearables/watch-face-push).\n\n Android Studio also includes support for building and running watch faces\n that use Watch Face Format.\n | **Note:** The guides on how to [represent the time](/training/wearables/wff/time), and subsequent guides within this part of the documentation, target developers who either use XML or build custom tools to create watch faces using Watch Face Format.\n\nWatch faces built with this format require less maintenance and fewer updates\nthan those built using the legacy Jetpack Watch Face libraries. For example, you\ndon't need to update your watch face to benefit from improvements in performance\nor battery consumption, or to get the latest bug fixes.\n\nAbout the format\n\nAt the heart of a Watch Face Format (WFF) watch face is a document that defines\nthe layout and behavior of the watch face. This document is written in XML,\nconforming to the WFF specification.\n\nThe Wear OS system includes a watch face renderer component. This component\nparses your WFF XML document and renders a watch face from it. Other resources,\nsuch as images and fonts, are pulled in as necessary.\n\nThis approach means you only need to spend time describing how the watch\nface should look, and Wear OS handles all of the code for drawing the watch\nface.\n\nTo deploy a Watch Face Format watch face to a device, package the XML document\nin a standard AAB or APK package.\n\nThe following diagram shows an overview of the approach:\n\nVersioning in WFF\n\nAs WFF evolves, additional features are added, represented by more elements,\nattributes, and data sources that all use the Watch Face Format.\n\nFor example, WFF version 2 introduced Weather support as a data source, which\nis not available in WFF version 1.\n\nWhen designing your watch face, be aware of which features you\nwant to use and their version availability. The reference guide marks\nall features with their availability.\n\nEach version of WFF aligns with a Wear OS release:\n\n| WFF version | Minimum Wear OS version | Minimum API level |\n|-------------|-------------------------|-------------------|\n| 1 | 4 | 33 |\n| 2 | 5 | 34 |\n| 3 | 5.1 | 35 |\n| 4 | 6 | 36 |\n\n[See this guidance](/training/wearables/wff/setup#declare-wff-use) for configuring your `AndroidManifest.xml` and Gradle\nbuild file appropriately.\n\nLearn more\n\nLearn more about the Watch Face Format in these guides:\n\n- [Available features](/training/wearables/wff/features): Explore the watch face capabilities that each version of Watch Face Format supports.\n- [Design guidelines](/design/ui/wear/guides/surfaces/watch-faces): Learn best practices for your watch face's layout and user experience.\n- [Watch Face Designer](/training/wearables/watch-face-designer): Learn how to use the Figma plugin to create your watch face.\n- [Setup](/training/wearables/wff/setup): Configure an Android App Bundle that supports the Watch Face Format.\n- [GitHub samples](https://github.com/android/wear-os-samples/tree/main/WatchFaceFormat): Get started by building sample watch faces and deploying them on the Wear OS emulator or your physical device.\n- [Optimize memory usage](/training/wearables/wff/memory-usage): Learn how to configure your watch face so the system consumes as little memory as possible when rendering your watch face.\n- [XML reference](/training/wearables/wff/watch-face): Explore the individual elements that are parts of a Watch Face Format file. The root element is always `WatchFace`. Note: To view features from a specific Watch Face Format version in the XML reference, check that the appropriate version button is selected at the top of the documentation page.\n- [Publishing guide](https://support.google.com/googleplay/android-developer/answer/13560201): Learn how to publish and monetize your watch face through the Play Store and alternative methods.\n- [WFF and memory validator](https://github.com/google/watchface): Use these open source tools to check your Watch Face Format file for errors and confirm acceptable memory usage before submitting to Google Play."]]
