Getting Started

Requirements

License Key

A license key linked to your application is needed to use MobbScan Xamarin. Please, contact us to obtain one if you don't have one yet, or ask your contact person at Mobbeel.

Dependencies

Frameworks

  • NETStandard.Library 2.1.0

NuGet Packages

IdVersion
Xamarin.Forms4.4.0.991265
Xamarin.Essentials1.3.1

NuGet Packages

IdVersion
Xamarin.Forms4.4.0.991265
Xamarin.Essentials1.3.1
Xamarin.Android.Support.Core.Utils28.0.0.3
Plugin.CurrentActivity2.1.0.4
Xamarin.Kotlin.StdLib.Jdk71.3.50.1
GoogleGson2.8.5

Assembly References

IdVersion
Mono.Android (Xamarin.Android 9.0 Support)0.0.0.0
EventBus.Android.Binding2.4.0.0
Protocol.Buffers.Binding2.5.0.0
SpongyCastle.Core.Android.Binding1.54.0.0
SpongyCastle.Pkix.Android.Binding1.54.0.0
SpongyCastle.Prov.Android.Binding1.54.0.0
TessTwo.Android.Binding9.0.0.0

Assemblies in italics are supplied within libs/third-party/Android folder. You may link those ones or create your own binding libraries for the required Android dependencies (learn more).

NuGet Packages

IdVersion
Xamarin.Forms4.4.0.991265
Xamarin.Essentials1.3.1

Assembly References

IdVersion
Xamarin.iOS0.0.0.0

Tooling

Installation & Configuration

MobbScan Package Setup

  1. Ensure that you meet all the requirements exposed above. Please, make sure you followed the instructions for all hte required packages to set them up as some of them may need extra configuration (ie: Plugin.CurrentActivity)

  2. Add the supplied Mobbeel.MobbScan package to your local NuGet repository by running the following command:

    $ nuget add path_to_libs/Mobbeel.MobbScan.nupkg -source your_local_nuget_repo_folder

    Tip! Find out here how to set up a local NuGet repository.

  3. Install the Mobbeel.MobbScan package into your .NET Standard project and Client projects

  4. Register MobbScan API implementation in the Xamarin Forms Dependency Service of both Client projects. The registration should be done before any reference to MobbScan API takes place in your code. The following points are good places to register the dependency:

/* MainActivity.cs */

protected override void OnCreate(Bundle savedInstanceState)
{
    ...

    CrossCurrentActivity.Current.Init(this, savedInstanceState);

    Xamarin.Forms.DependencyService.Register<XMobbScanAPI>();

    LoadApplication(new App());
}
/* AppDelegate.cs */

public override bool FinishedLaunching(UIApplication app, NSDictionary options)
{
    ...

    Xamarin.Forms.DependencyService.Register<XMobbScanAPI>();

    LoadApplication(new App());

    return base.FinishedLaunching(app, options);
}

Platform Specific Configuration

Some aditional setup is required depending on the platform.

  1. Add the required permissions. Learn more in point 4 of this document.
  2. Select d8 as Dex Compiler. Go to Project Options > Build > Android Build > General and select:
    Dex Compiler: d8
  3. Multi-Dex must be enabled. Go to Project Options > Build > Android Build > General and check:
    ☑︎ Enable Multi-Dex
  1. Set the linker behaviour. Navigate to Project Options > Build > iOS Build > Code Generation & Runtime and select:
    Linker behavior: Link All
Hands-on Example →