Quickstart

Follow these steps to have a basic integration of the app's miles® SDK in your Xamarin application.

Xamarin Quickstart

Work In Progress

Conditions and minimum requirements

Minimum Android version: 4.1 (API 16) Minimum iOS version : 7.0 Minimum XCode version : 7

I. Installation

We publish the Xamarin SDK on Nuget under the name of XAPM

Adding NuGet packages

You need to add NuGet packages in 3 different places:

• Main project

• iOS project

• Android project

Main project

In main project, add NuGet package :

• XAPM.Interface

iOS

In iOS project, add NuGet packages :

• XAPM.Interface

• XAPM.iOS.Impl

• XAPM.iOS.SDK

Android

In Android project, add NuGet packages :

• XAPM.Interface

• XAPM.Droid.Impl

• XAPM.Droid.SDK

II. Configuration

No additional configuration required

III. Initialization

You will also need to initialize the SDK in 3 different places

Main project

In main project, in file App.xaml.cs, init the SDK :

• partnerID : <PARTNER_ID>

• partnerSecret : <PARTNER_SECRET>

• appId : <APP_ID>

• baseUrl : <BASE_URL>

App.xaml.cs

public App()
{
    InitializeComponent();
    
    APM.Register();
    APM.SetBaseUrl(<BASE_URL>);
    APM.InitApp(<PARTNER_ID>, <PARTNER_SECRET>, <APP_ID>);
    
    MainPage = new MainPage();
}

In file MainPage.xaml.cs, call the method APM.RefreshSDK();

MainPage.xaml.cs

public MainPage()
{
    InitializeComponent();
    
    APM.RefreshSDK();
}

iOS

In iOS project, in file AppDelegate.cs, init iOS SDK :

AppDelegate.cs

public override bool FinishedLaunching(UIApplication app, NSDictionary options)
{
    global::Xamarin.Forms.Forms.Init();
    LoadApplication(new App());
    
    XAPM.iOS.Impl.Initializer.Init();
    
    return base.FinishedLaunching(app, options);
}

Android

In Android project, in file MainApplication.cs, init Android SDK :

MainApplication.cs

public override void OnCreate()
{
    base.OnCreate();
    RegisterActivityLifecycleCallbacks(this);
    // A great place to initialize Xamarin.Insights and Dependency Services!
    XAPM.Droid.Impl.Initializer.Init();
}

You're done with the installation !

You should be able to see our SDK on your application.

And the banner appear !

Head to the next section to start integrating our SDK into your app's features.