Home

Awesome

Tizen Wearable CircularUI

Codacy Badge Build Status

Introduction

The Tizen Wearable CircularUI project is a set of helpful extensions of the Xamarin Forms framework.<br> The aim of the Tizen Wearable CircularUI project is an open source software to motivate and help software developer to create Tizen Wearable app(Xamarin.Forms app) more easily and efficiently.<br> The binaries are available via NuGet (package name Tizen.Wearable.CircularUI)<br>

Xamarin Forms provides cross-platform APIs, but this project are only worked on the Samsung Gear device that support Tizen .NET.

Controls

The Tizen Wearable CircularUI project provides UI controls that fit on a circular screen and interact with hardware features provided on a Samsung wearables such as bezel rotation.

widgets

Tizen Wearable CircularUI project also provides extended Xamarin.Forms controls. These controls basically look same as what it is in Xamarin.Forms, but provide additional features just for Tizen wearables. The developers would want to use the following controls only when they specifically need to use the provided features in each controls.

:information_source: In the case of WatchApplication(Watchface App), to use the controls below, you must use it with a class that implements ICircleSurfaceProvider (e.g., CircleSurfaceView) or CircleSurfaceEffectBehavior.

widgets

Deprecated APIs

Following controls are obsolete as of Tizen.CircularUI version 1.5.0.<br/> However, they can be substituted with Xamarin.Forms controls. Below shows how they can be substituted based on Xamarin.Forms 4.6.0 Service Release 2 (4.6.0.800) or higher.

Prerequisite

How to use CircularUI

Sample and Test application using CircularUI

<table> <tr> <th></th> <th>Screenshot</th> <th>Description</th> </tr> <tr> <td>WearableUIGallery</td> <td><img src="doc/design/data/cui_widgets.png" alt="widgets"></td> <td>This application was created to check the basic behavior of CircularUI API. It contains all the controls of the CircularUI API, and the functions of each control consist of one TC or several TCs depending on the characteristics of the control.<br> - Install guide : sdb install org.tizen.example.WearableUIGallery.Tizen.Wearable-1.0.0.tpk <br> <a href="https://github.com/Samsung/Tizen.CircularUI/tree/master/test/WearableUIGallery">Source</a></td> </tr> <tr> <td>SimpleTextWatchface</td> <td><img src="doc/design/data/SimpleWatchface_1.png" alt="widgets"></td> <td>This application was created to check the default behavior of the Watchface API. <br> - Install guide : sdb install org.tizen.example.SimpleTextWatchface-1.0.0.tpk <br> - Test guide : <br> 1) Touch and hold on Watchface of Main page <br> 2) Move to left on watchface list and select SimpleTextWatchface icon <br> 3) You can see `SimpleTextWatchface` on Watchface of Main page <br> <a href="https://github.com/Samsung/Tizen.CircularUI/tree/master/test/SimpleTextWatchface">Source</a> </td> </tr> <tr> <td>XUIComponents</td> <td><img src="doc/design/data/XUIComponent.png" alt="widgets"></td> <td>This application is similar to the UIComponents application using the native API. The functions of each control consist of several test cases depending on the characteristics of the control. <br> - Install guide : sdb install org.tizen.example.UIComponents.Tizen.Wearable-1.0.0.tpk <br> <a href="https://github.com/Samsung/Tizen.CircularUI/tree/master/sample/XUIComponents">Source</a></td> </tr> </table>

Tip and Tech