Xamarin iOS SDK Quick Start Guide

The goal of this document is for the user to get the nuu:bit Xamarin SDK functional quickly. The figure below is a high-level diagram of the workflow:


Step 1 - Sign in to the nuu:bit portal (https://portal.nuubit.net/) using your existing nuu:bit portal credentials.



Step 2 - Select the "Mobile Apps" tab from the top of the portal page.  Choose the operating system from the left of the column (currently only iOS SDK is provided/supported, Android support will be available in April 2017).



Step 3 - Select Add new app button:


Step 4 - Enter the App name - in this example below, the App is called “MyExampleApp”:


Step 5 - Once the App is registered on the nuu:bit Platform, use the “Create App” button.

Step 6 - The newly added App should appear in the iOS Apps List.   



Step 7 - Access the SDK key by clicking on the eye icon.  This will reveal the SDK key that will be used in the mobile App to initialize the nuu:bit SDK code.




Step 8 - Download "nuubit.SDK" NuGet package from nuget.org or run the following command in the Package Manager Console: 


Install-Package nuubit.SDK


Additionally the SDK can be downloaded from the Xamarin Component Store and addede to your Xamarin.iOS project.

References to 3 assemblies will be added: iOSnuu:bit.dll, nuu:bit.dll, RevSDK.dll.


Step 9 - Add "NuubitSDK" namespace in AppDelegate.cs in Xamarin iOS application code


using Nuubit.SDK;

Step 10 - Insert initialization for nuu:bit SDK to AppDelegate.cs FinishedLaunching method:

   public partial class AppDelegate : UIApplicationDelegate

       public override bool FinishedLaunching(UIApplication app, NSDictionary options)

           RevSDK.StartWithSDKKey("put here the SDK key from Step 7");  


Step 11 - Add "Nuubit.SDK" namespace to shared AppDelegate.cs file:


using Nuubit.SDK;


Step 12 - Create instance of NuubitMessageHandler and use it for creating HttpClient:


var customMessageHandler = new NuubitMessageHandler();
var client = new HttpClient(customMessageHandler);


Step 13 - Now you can send requests via the client.


// register a new client using the nuu:bit SDK
var customMessageHandler = new NuubitMessageHandler();
var client = new HttpClient(customMessageHandler);

// prepare the details of new request
HttpRequestMessage message = new HttpRequestMessage();
message.Method = new HttpMethod("GET");
message.RequestUri = new Uri("https://www.xamarin.com");

// Send the request via the nuu:bit SDK
var response = await client.SendAsync(message);

Step 16 - Compile and deploy the mobile application.


Step 17 (Optional) - Perform a fine-tuning of the SDK configuration for the app. Please see “SDK Configuration Guide” for details.


Step 18 - Use the “Apps Analytics” section in the nuu:bit customer portal to analyze the app data transfers and user base parameters.

Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk