/**
 * XWatchface
 * Copyright (C) 2014 by Dan Wallach <dwallach@cs.rice.edu>
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

This is a very simple Android Wear watchface based on the example watchface apps
distributed by Google.

What's useful and interesting is that it shows you how listen to broadcasts from a
stopwatch and timer and render them. Some things to examine:

AndroidMainfest.xml: This is pretty much exactly what you'd expect to see for any
watchface, except for the <receiver> element, which says that we're interested in
receiving broadcast intents from stopwatches and timers.

XWatchfaceService.java: This is very similar to the stock sweeping-hand watchface
code that you'll find in the examples that Google ships. What's new is the call to
XDrawTimers.draw() and XWatchFaceReceiver.pingExternalStopwatches().

XWatchfaceReceiver.java: When a stopwatch or timer has an update to send, this is
where we're going to receive it. You probably want to just include this entire file
without changing anything.

XDrawTimers.java: This is a very, very basic way to add stopwatch and timer rendering
into your own watchface. For the stopwatch, it draws a minute hand and a second hand.
If the stopwatch is reset, it draws nothing. If it's in ambient mode, it just draws
the minute hand. For the timer, it only draws one hand that sweeps counterclockwise,
starting and ending at 12 o'clock. You should, of course, feel free to embellish on
this and do something else.


RELATED LINKS

XStopwatch & XTimer: Two apps in one APK which implement a stopwatch and an timer.
https://play.google.com/store/apps/details?id=org.dwallach.xstopwatch
http://www.cs.rice.edu/~dwallach/xstopwatch/
https://github.com/danwallach/XStopwatch

CalWatch: A full-featured Wear watchface that also renders timers and stopwatches.
https://play.google.com/store/apps/details?id=org.dwallach.calwatch
http://www.cs.rice.edu/~dwallach/calwatch/
https://github.com/danwallach/CalWatch

Note / warning: This XWatchface Android Studio project isn't set up to produce something that
you can just upload to the Google Play Store. For that, you also need to set up a
"wrapper" mobile app.
https://developer.android.com/training/wearables/apps/packaging.html