The KidoZen SDK for Xamarin provides libraries and code samples for developers to build connected applications using KidoZen. This guide walks through the steps for setting up the SDK and running the tests.

For more information check this link

To get Your Credentials Register in kidozen.com.

Minimum requirements for using the KidoZen SDK for Xamarin are:

• Xamarin Studio 5.4
• Android SDK Version 17 or above

Passive authentication support. For more information check this link

The Unit Tests projects require your Marketplace's URL, Application's name, User, Password, etc directly into the code. This approach will get you running quickly, but we do not recommend it in a production application: a malicious user could use decompiling techniques to steal your KidoZen security credentials.

All unit tests demostrate how to access KidoZen from an application using the following services:

• Configuration
• EMail
• File
• Initialization
• Logging
• Marketplace
• Pubsub
• Queue
• SMS
• Storage

• In the solution, open KidoZen.Core.Tests project and open the file Constants.cs provide the values for all defined constant.

  • MarketplaceUrl: URL of the tenant's marketplece.
  • AppName: Name of the application that the tests will use
  • Provider: Name of the User Source to be used
  • User: User name that belongs to the User Source
  • Password: User's password
  • Emai: address that will be used in tests

• Build the project

• Run the the tests

##Application

To use KidoZen with an existing application, you have to add all the SDK's assemblies as references for the application project. You can find the assemblies at the ´bin´ folder.

One instance of the KZApplication object has the instances of each of the services that you can find in the Kidozen platform (Storage, Queue, etc.)

SDK API is await/async based on all its interfaces, so it will never block the UI.

Initialize the Application: During initialization the SDK pulls the application configuration from KidoZen servers.

var app = new KZApplication("https://marketplace's URL","application name"); 
await app.Initialize();

Authenticate: you must provide the user name, its password and the user source. The SDK hides all the calls needed to authenticate the user against the selected user source and to create a security tokens to execute all the services call. The SDK's has an internal cache to store these tokens. Each time the token is near get expired, teh SDk will renew it on the background.

var user = await app.Authenticate("userName", "userPassword","userSource");

Once the user is authenticated you can start using all the services:

var tasks = app.Storage["tasks"]; 
var queryResult = await tasks.Query<Task>("{}"); ...

var queue = app.Queue["pendingDocuments"]; 
var document = await queue.Dequeue<Document>(); ...

Copyright (c) 2013 KidoZen, inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.