Skip to content

Commit

Permalink
Documentation & Nuspec File Update
Browse files Browse the repository at this point in the history
  • Loading branch information
enisn committed Feb 8, 2019
1 parent f9aba6b commit 872e0f9
Show file tree
Hide file tree
Showing 3 changed files with 78 additions and 31 deletions.
56 changes: 56 additions & 0 deletions GettingStarted.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Getting Started with InputKit
Importing and using **InputKit** is easy as possible. It's plug & play logic. Just add to your project and use it.
> No more Init(); methods for your each platform !
<hr />

# Adding to your project
This plugin published on [NuGet](https://www.nuget.org/) to much more quicker implementation. This instructions uses nuget option.

- **Right Click** to your solution and go **Manage NuGet Packages**.
- Type to searchbar **Xamarin.Forms.InputKit** and find that package.
- Choose all platforms you want to use and click the **Install** button.

### Android
If you use it on Android platform there is just one more step.

- **Right Click** to your solution and go **Manage NuGet Packages**.
- Find and Install [Plugin.CurrentActivity](https://github.com/jamesmontemagno/CurrentActivityPlugin) from NuGet to your only Android Project!
- Add following code to **OnCreate** method of your **MainActivity** in Android Project.
```csharp
//...
base.OnCreate(savedInstanceState);
CrossCurrentActivity.Current.Init(this, savedInstanceState); // < ---- Add here
LoadApplication(new App());
//...
```

#### Why Do That on Android ?
Controls in InputKit uses current android activity to make some actions like open dropdown menu, changing color of icons,... etc.

<hr />

### iOS
Nothing more. Just Plug & Play!

<hr />

### UWP
This platform is Experimental. Some of features may not work!
It's not recommended to release your projects with InputKit on UWP platform.

But if want a try. No more code needed on UWP too.

<hr>

# Using at your Project
- Go to your XAML page and add following xml namespace to your **ContentPage** tag as like [this sample](https://github.com/enisn/Xamarin.Forms.InputKit/blob/f9aba6b7ce104c1466b521a59830d69956e5cc54/Sample.InputKit/Sample.InputKit/MainPage.xaml#L5)
```csharp
xmlns:input="clr-namespace:Plugin.InputKit.Shared.Controls;assembly=Plugin.InputKit"
```
*[See how it should be done at sample](https://github.com/enisn/Xamarin.Forms.InputKit/blob/f9aba6b7ce104c1466b521a59830d69956e5cc54/Sample.InputKit/Sample.InputKit/MainPage.xaml#L5)*
- Then use it at wherever you want in your page with defined prefix `input` like following code:
```csharp
<input:CheckBox Text="Option 5" IsChecked="True" Type="Material"/>
```
19 changes: 14 additions & 5 deletions InputKit.nuspec
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<id>Xamarin.Forms.InputKit</id>

<!-- The package version number that is used when resolving dependencies -->
<version>2.3.6.1</version>
<version>2.3.6.2</version>

<!-- Authors contain text that appears directly on the gallery -->
<authors>enisn</authors>
Expand Down Expand Up @@ -36,8 +36,8 @@
<description>
...
This package includes awesome controls to get inputs easily from users and make validation easier.
Just import NuGet package to your project and use it!
Just import NuGet package to your project and use it!

There is no any Init() methods for your each platform!

</description>
Expand All @@ -50,8 +50,17 @@

<!-- Dependencies are automatically installed when the package is installed -->
<dependencies>
<dependency id="Xamarin.Forms" version="3.1.0.583944" />
</dependencies>
<group>
<dependency id="Xamarin.Forms" version="3.2.0.839982" />
</group>
<group targetFramework="MonoAndroid81">
<dependency id="Xamarin.Forms" version="3.2.0.839982" />
<dependency id="Plugin.CurrentActivity" version="2.1.0.4" />
</group>
<group targetFramework="Xamarin.iOS10">
<dependency id="Xamarin.Forms" version="3.2.0.839982" />
</group>
</dependencies>
</metadata>

<!-- A readme.txt to display when the package is installed -->
Expand Down
34 changes: 8 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,41 +9,16 @@
</table>




<hr />

[![Build status](https://ci.appveyor.com/api/projects/status/st6lcbts9bkhxqub?svg=true)](https://ci.appveyor.com/project/enisn/xamarin-forms-inputkit)
[![CodeFactor](https://www.codefactor.io/repository/github/enisn/xamarin.forms.inputkit/badge)](https://www.codefactor.io/repository/github/enisn/xamarin.forms.inputkit)
<a href="https://www.nuget.org/packages/Xamarin.Forms.InputKit/"><img src="https://img.shields.io/badge/Nuget-2.3.6.1-blue.svg" /></a>
<a href="https://github.com/enisn/Xamarin.Forms.InputKit/wiki"> <img src="https://img.shields.io/badge/Visit-WiKi-orange.svg"/></a>
<hr/>
<p>

## You can offer new controls!

You can contribute and type your feedbacks about new controls and featues from [here](https://github.com/enisn/Xamarin.Forms.InputKit/issues/45).

</p>

<hr/>

### Also You may interested in:

<table border="0">
<tr>
<td>
<a href="https://github.com/enisn/Xamarin.Forms.MaterialKit"> <img height="50" src="https://camo.githubusercontent.com/56583f8e2349013be52ef8a0bfa5a485094fcb40/687474703a2f2f656e69736e656369706f676c752e636f6d2f506c7567696e732f6d6174657269616c6b69745f636f72652e706e67" /> </a>
</td>
<td>
<a href="https://github.com/enisn/Xamarin.Forms.MaterialKit/tree/master/Lib/MaterialKit.Backdrop"> <img height="50" src="https://camo.githubusercontent.com/42a15bc88498c0cbcfcb925de3cac313aa34f14a/687474703a2f2f656e69736e656369706f676c752e636f6d2f506c7567696e732f6d6174657269616c6b69745f6261636b64726f702e706e67" /> </a>
</td>
<td>
<a href="https://github.com/enisn/Xamarin.Forms.MaterialKit/tree/master/Lib/MaterialKit.Backdrop"> <img height="50" src="https://camo.githubusercontent.com/52af9c689718723e1bbca2337fb7c9e17ec742c9/687474703a2f2f656e69736e656369706f676c752e636f6d2f506c7567696e732f6d6174657269616c6b69745f63686970732e706e67" /> </a>
</td>
</tr>
</table>


## Available Platforms

Expand All @@ -52,13 +27,19 @@ You can contribute and type your feedbacks about new controls and featues from [
| --- | --- | --- |
| Android | MonoAndroid80 | YES |
| iOS | Xamarin.iOS10 | YES |
| UWP | - | YES * |
| UWP | - | **EXPERIMENTAL** |
| MAC | Xamarin.Mac20 | YES |
| WatchOS | Xamarin.WatchOS10 | YES |
| .NET Standard | 2.0 | YES |
| .NET Standard | 1.0 | **NO** |

<hr/>

## Getting Started with InputKit

There is no complicated steps for set-up, no Inits no implementation codes. Plug & Play.

Read [Documentation of Getting Started](https://github.com/enisn/Xamarin.Forms.InputKit/wiki/Getting-Started).

<hr />

Expand All @@ -67,6 +48,7 @@ You can contribute and type your feedbacks about new controls and featues from [
</a>
<p>As you know ther is no CheckBox in Xamarin Forms Library. You can use a custom renderer to use Native Checkbox in portable layer. This CheckBox is not a native one, It's created in Xamarin Forms Portable layer.</p>

<p>Also you can read more about Checkbox from <a href="https://github.com/enisn/Xamarin.Forms.InputKit/wiki/CheckBox">here</a> </p>
<h4>SAMPLE:</h4>

```xaml
Expand Down

0 comments on commit 872e0f9

Please sign in to comment.