diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100755 index 00000000..eb4fbd2e --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,46 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. + +## Our Standards + +Examples of behavior that contributes to creating a positive environment include: + +* Using welcoming and inclusive language +* Being respectful of differing viewpoints and experiences +* Gracefully accepting constructive criticism +* Focusing on what is best for the community +* Showing empathy towards other community members + +Examples of unacceptable behavior by participants include: + +* The use of sexualized language or imagery and unwelcome sexual attention or advances +* Trolling, insulting/derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or electronic address, without explicit permission +* Other conduct which could reasonably be considered inappropriate in a professional setting + +## Our Responsibilities + +Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. + +Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. + +## Scope + +This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at tizenapi@samsung.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. + +Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version] + +[homepage]: http://contributor-covenant.org +[version]: http://contributor-covenant.org/version/1/4/ diff --git a/PULL_REQUEST_TEMPLATE.md b/PULL_REQUEST_TEMPLATE.md new file mode 100755 index 00000000..f723cc92 --- /dev/null +++ b/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,27 @@ +### Description of Change ### +Describe your changes here. + + +### Bugs Fixed ### +- Describe bugs detail information(step to reproduce, version of binary, etc ...) or provide links to bugs here + + +### API Changes ### +List all API changes here +(or just put None when your changes are only bug fix, behavior change, add/fix testcase, add/fix sample), example: + +Added: + - Add CircleStackLayout + - Add add LabelFormat property at CircleStepper + public string LabelFormat + +Changed: + - Change name of Color property + public Color Color => public Color MarkerColor + + Removed: + - Remove popup style at Check + +### Behavioral Changes ### +Describe any non-bug related behavioral changes that may change how users app behaves when upgrading to this version of the codebase. + diff --git a/README.md b/README.md index 1f55cd08..164ff8d3 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,26 @@ # Tizen CircularUI -The Tizen CircularUI is a set of helpful extensions to the Xamarin Forms framework on the Samsung Gear device. -The banaries are available via NuGet (package name CircularUI) with the source available at here. +[![License](https://img.shields.io/badge/licence-Apache%202.0-brightgreen.svg?style=flat)](LICENSE) + + +- [Introduction](#introduction) +- [Controls](#controls) +- [Prerequisite](#prerequisite) +- [How to use CircularUI](#how-to-use-circularui) + +## Introduction +The Tizen CircularUI project is a set of helpful extensions of the Xamarin Forms framework.
+The aim of the Tizen CircularUI project is to develop an open source software motivate software developer to creating Tizen Wearable Xamarin Forms app more easily and efficiently.
+The binaries are available via NuGet (package name CircularUI)
+ +_Xamarin Forms provides cross-platform APIs, but this project are only worked on the Samsung Gear device that support Tizen .NET._ + ## Controls +The Tizen CircularUI project provides you the following UI controls: -- CirclePage : A subclass of Xamarin.Forms.Page that can shows Circlular ProgressBar and Circular Slider and the button on bottom of screen. it can also show MenuItems on the circular menu.(MoreOption) -- CircleListView : A subclass of Xamarin.Forms.ListView control fits in the circular screen. +- CirclePage : A subclass of Xamarin.Forms.Page that can show circular ProgressBar and circular Slider and Button on bottom of screen. it can also show MenuItems on the circular menu.(MoreOption) +- CircleListView : A subclass of Xamarin.Forms.ListView control fits in the circular screen and have circular scroll bar. - CircleProgressBarSurfaceItem : A control fits in the circular screen. it can be shown in CirclePage only. - CircleSliderSurfaceItem : A Slider control that responds to the bezel action and fits in the circular screen. - CircleScrollView : A subclass of Xamarin.Forms.ScrollView that can be scrolled by the bezel action. @@ -14,9 +28,9 @@ The banaries are available via NuGet (package name CircularUI) with the source a - CircleStepper : A control to select a number of steps fits in the circular screen. - CircleStackLayout : A container to layout children linear in the circular area. - IndexPage : A subclass of multiple page that can slide child page horizontal and has dots on top of the screen for the number of child pages. -- Check : A subclass of Xamarin.Forms.Switch control with some different styles. +- Check : A subclass of Xamarin.Forms.Switch control supports tizen specific style. - RotationReceiver : A event receiver for using the bezel action. -- Radio : A radio control fits in the circular screen. +- Radio : A radio control. - Toast : A popup for simple feedback. - TwoButtonPage : A subclass of Xamarin.Forms.Page has two button in left and right side of the circular screen. - ContextPopup : A context popup fits in the circular screen. @@ -24,4 +38,15 @@ The banaries are available via NuGet (package name CircularUI) with the source a - ConfirmPopupEffect : the effect to show a small popup has one or two button sticky with any control. - InformationPopup : A popup has a control to show progress and one button in bottom side of circular screen. -![widgets](doc/design/data/widgets.png) \ No newline at end of file +![widgets](doc/design/data/widgets.png) + +## Prerequisite + - Visual Studio 2017 + - Visual Studio Tools for Tizen + - [How to install Visual Studio Tools for Tizen](https://developer.tizen.org/development/visual-studio-tools-tizen/installing-visual-studio-tools-tizen) + - Installing Tizen Wearable emulator image (WEARABLE-4.0-Emulator or WEARABLE-5.0-Emulator) + +## How to use CircularUI +- [How to make Tizen Wearable Xamarin Forms App with CircularUI](doc/guide/HOW_TO_MAKE_TIZEN_XAMARIN_FORMS_APP_WITH_CIRCULARUI.md) + +- The [API Reference](https://github.sec.samsung.net/pages/dotnet/apidoc/XamarinFormsCircularUI/api/index.html) is available on the web to browse. \ No newline at end of file diff --git a/doc/guide/HOW_TO_MAKE_TIZEN_XAMARIN_FORMS_APP_WITH_CIRCULARUI.md b/doc/guide/HOW_TO_MAKE_TIZEN_XAMARIN_FORMS_APP_WITH_CIRCULARUI.md new file mode 100755 index 00000000..a8223020 --- /dev/null +++ b/doc/guide/HOW_TO_MAKE_TIZEN_XAMARIN_FORMS_APP_WITH_CIRCULARUI.md @@ -0,0 +1,140 @@ +# How to make Tizen Xamarin Forms App with CircularUI + +- Create Tizen Xamarin Forms App following to [Tizen.org guide](https://developer.tizen.org/development/training/.net-application/creating-your-first-tizen-.net-application). + In this guide project name is `SampleCircleApp` + + + +- Select only wearable device at tizen project wizard.
+ ![wizard](data/tizen_project_wizard_capture.png) + + + +- Search Tizen.CircularUI nuget pakage at Nuget package manager.
+ ![nuget](data/nuget_package_manager_capture.png) + + + +- Install Tizen.CircularUI nuget at portable class library(PCL) project.
+ ![pcl](data/after_Install_nuget_package.png) + + + +- remove SampleCircleApp.cs that is generated automatically at PCL. and then add App.xaml and App.xaml.cs using add item. + +- Insert code at App.xaml.cs + +``` +using CircularUI; +using System; + +using Xamarin.Forms; +using Xamarin.Forms.Xaml; + +namespace SampleCircleApp +{ + internal static class WidgetName + { + public const string Slider = "slider"; + public const string Progress = "progress"; + } + + [XamlCompilation(XamlCompilationOptions.Compile)] + public partial class App : Application + { + public App() + { + InitializeComponent(); + } + + public void OnButtonClicked(object sender, EventArgs e) + { + Toast.DisplayText("Toast popup", 3000); + } + } +} +``` + + + +- Insert xaml code at App.xaml file + +``` + + + + + + + + +