Whatfix 0.4.2

Integrate Whatfix SDK into your Xamarin.Android project

Prerequisites:

• Android Studio
• Android Min SDK version: 19
• Xamarin.Forms - 4.8.+

Step 1: Obtain the packages from NuGet.

The package is available on NuGet on this Whatfix .

In your Xamarin.Android project, Right Click on Packages. Select Manage NuGet Packages in the context menu. Search for 'whatfix sdk' in the search bar. Add both the Whatfix package to the library.

Step 2: Select the version of the SDK

In the Nuget Package Installer, Select the latest version of the SDK in the New version dropdown.

Step 3: Add Initialize in MainActivity.cs file.

//Xamarin.Android
protected override void OnCreate(Bundle savedInstanceState)
{
 base.OnCreate(savedInstanceState);
 var app = new App();
 LoadApplication(app);
 WhatfixSDK.WhatixSDK.Initialize(app, this, "<ent_name>", "<ent_id>"
 , "<screen_id>", segmentationOptions, whatfixOptions
 );
}

Note: Replace <ent_id> and <ent_name> with your Whatfix account ID. To get your ENT ID & ENT_NAME, email us at support@whatfix.com or get in touch with your Account Manager.

WhatfixOptions:

Sdk.Whatfix.Common.WhatfixOptions whatfixOptions = new Sdk.Whatfix.Common.WhatfixOptions();
whatfixOptions.CdnHost = "test.whatfix.com";// Add this option to set your custom host to serve content.Default is [cdn.whatfix.com](http://cdn.whatix.com/)
whatfixOptions.StartEditor = false;// Set this option to true in order to start editor directly
whatfixOptions.DebugEnabled = true;// Set this option to true in order to enable seeing the extra logs on Logcat
whatfixOptions.EditorDisabled = false;// Set this option to true in order to disable invocation of editor

SegmentationOptions:

Sdk.Whatfix.Common.SegmentationOptions segmentationOptions = new Sdk.Whatfix.Common.SegmentationOptions();

segmentationOptions.LoggedInUserId = "john_doe";// Add this option to set the current user id for analytics
segmentationOptions.LoggedInUserRole = "manager";// Add this option to set the current user role from your app
segmentationOptions.Language = "fr";// Add this option to set the current user language preference

Sdk.Whatfix.Whatfix.RefreshWindowVariable(segmentationOptions);// segmentationOptions can be passed at initialize. If using at any other place, 
 RefreshWindowVariable has to be called

TroubleShooting :

• If operating the app inside VPN, kindly make sure that the domain “whatfix.com“ and any sub-domains are white-listed.

• If you encounter any errors while compiling, kindly run Clean Build and then Build again.

• Check the logs to see if Whatfix Logs are available and if SDK was successfully initialized.