The Watch Face Format is required for watch faces to be installed on devices with Wear OS 5 pre-installed starting July 10, 2024, and for all new watch faces published on Google Play starting January 27, 2025.
Learn more about the user-facing changes in this Help Center article.
Address watch face issues
Stay organized with collections
Save and categorize content based on your preferences.
Creating a custom watch face for Wear OS by Google is substantially different from
creating notifications and wearable-specific activities. This page describes
some issues you might encounter as you implement your first few watch faces.
Use relative measurements
Wear OS devices from different manufacturers feature screens with a variety of sizes and
resolutions. Your watch face can adapt to these variations by using relative measurements
instead of absolute pixel values.
When you draw your watch face, obtain the size of the canvas with the
Canvas.getWidth()
and Canvas.getHeight()
methods. Then, set the positions of your
graphic elements using values that are some fraction of the detected screen size. If you
resize the elements of your watch face in response to a peek card, use values that are
some fraction of the space remaining above the card to redraw your watch face.
The
Watch face sample app demonstrates the best practices for configuring a watch face.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-11-12 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-12 UTC."],[],[]]