A sample demonstrating the structure of Watch Face Format watch faces
The Watch Face Format (WFF) allows developers to build watch faces, and watch face design tools in a XML format.
This sample demonstrates the basic structure of a WFF watch face, and how it should be packaged for uploading to Play or for local testing on an emulator or device.
For more details on the Watch Face Format, see:
- Watch Face Format overview
- Watch Face Format setup
- XML reference
- Design guidance
- Validator tools and Schema
There are currently three samples available:
SimpleDigital- A basic digital watch face.SimpleAnalog- A basic analog watch face.Complications- Demonstrates using Complications in a watch face and rendering data from Complication data sources.
Use Gradle to build each of the samples. For example, to build the
SimpleDigital debug build:
cd SimpleDigital
./gradlew assembleDebugTo then install and set as the current watch face on a device or emulator:
adb install watchface/build/outputs/apk/debug/watchface-debug.apk
adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation set-watchface --es watchFaceId com.example.simpledigitalFor more guidance on building and signing release builds, see signing guidance on developer.android.com
-
Use the XML validator to confirm that the XML in
watchface.xmlis valid. -
Use
logcatto look for any error messages from the WFF runtime, such as potential errors in WFF expressions.adb logcat --pid=$(adb shell pidof -s com.google.wear.watchface.runtime)
- Stack Overflow: https://stackoverflow.com/questions/tagged/wear-os
- Error Reporting: If you've found an error in this sample, please file an issue: https://github.com/android/wear-os-samples
- Submitting Patches: Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details.