AirWatch Developer Guide for Xamarin Android


App Configuration > AirWatch SDK (Xamarin Android)


The steps in this tutorial are done with the assumption that you have gone through the steps in General Setup tutorial as well as the SDK Setup section.

Important: You will need to download the SDK binary separately via


  • Android 4.0+ / Ice Cream Sandwich / API Level 14+
  • Xamarin Studio – if you have Visual Studio with the Xamarin plugin, this should also work, but this document is based on Xamarin Studio.
  • Android Test Device
  • AirWatch Agent v5.3+ for Android (Requirement be lower depending on features used)
  • The AirWatch Xamarin Android SDK from the Xamarin Component Store AWClient-SDK.dll.


Step 1: Integrate the AirWatch SDK

Follow the instructions to integrate the AirWatch Software Development Kit (SDK) for Xamarin Android into your application if you haven’t already done so.

Step 2: Add Custom Settings in your SDK profile

For this next part, you will need to check which profile you have assigned to your SDK app. You can do this by navigating to Apps & Books > Details View. Click Edit. Choose More > SDK. Check what profile is assigned for SDK Profile.

Using the Default SDK Profile (Recommended)

  1. If the profile assigned is the default profile, then the policy settings can be edited by navigating to Apps & Books > All Apps & Books Settings > Apps > Settings And Policies > Settings.
  2. Enable the custom settings and add your custom settings. This is a string field and can contain XML, JSON, or plain text. You can also insert lookup values if desired. 
  3. Once you are done, click save to start enforcing the new policy.

Using a custom profile

  1. In the *AirWatch Console, Choose Apps & Books > All Apps & Books Settings.
  2. Choose Settings and Policies > Profiles and click Add Profile to create a custom profile or edit an already existing profile currently assigned to your app.
  3. You will be asked to Choose SDK Profile or Application Profile. Select the SDK profile.
  4. Choose Android and fill in the Name field on the General Tab.
  5. Click Custom Settings on the left, and add your custom settings. This is a string field and can contain XML, JSON, or plain text. You can also insert lookup values if desired. 
  6. Save the Profile.

Step 3: Retrieving the Profile within Your Application

The code to retrieve these settings within the app is very simple if SDK integration in the setup section in step 1 is already done.

var sdkManager = SDKManager.Init (activity);
String customSettings = sdkManager.CustomSettings;

Use these settings however you wish in your app!

Edit Add


Add Comment
Pelin Alp
This works http post and get requests with no problem. But my app has webviews. Webviews don't open with tunneling. How to work tunnel on the webview? What should I do for tunnel in webview?
Posted on 1/26/23 12:04 AM.