Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Dynamics Bindings for Xamarin.Android 7.0
  3. BlackBerry Dynamics Bindings for Xamarin.Android Development Guide
  4. Optionally implementing the BlackBerry Dynamics Launcher

Optionally implementing the
BlackBerry Dynamics Launcher

The
BlackBerry Dynamics Launcher
 is optional code to start the popular UI front-end to many
BlackBerry Dynamics
-based apps. For background, see Development Guide: BlackBerry Dynamics Launcher Library.
You add the
BlackBerry Dynamics Launcher
 button to an activity and include the
BlackBerry Dynamics Launcher
 authentication logic in the appropriate place in your app.
You need to have installed the
Xamarin
 bindings as detailed in Install the BlackBerry Dynamics SDK.

General steps

  2. Unzip the packages.
  3. In your desired IDE, load the bindings into the desired projects. For each project you want to use the Launcher binding in, do the following:
    • Right click
      References
       and click
      Edit References
       to reference the Launcher project. The important file here is
      AndroidLauncherBinding.dll
      .
    • In the
      Components
       folder of the project, add the "Android Support Library v13" component for backwards compatibility.
  4. Make sure the
    AndroidLauncherBinding
     project properly references the following
    Android
     Support packages. If they are not there, add them to the project's packages and reference them within the
    AndroidLauncherBinding
     project.
    • Xamarin.Android.Support.v13.25.3.1 or later
    • Xamarin.Android.Support.v4.25.3.1 or later
  5. In your app, include the package
    Using Com.Good.Launcher;
  6. Add the
    BlackBerry Dynamics Launcher
     to the activity you want it to appear on. The
    BlackBerry Dynamics Launcher
     can be initialized using either an inclusive or an exclusive list of activities. If an inclusive list is used, the
    BlackBerry Dynamics Launcher
     is shown only on the included activities and vice versa.
    In this example, we are only adding it to the main activity. 
    List includedActivities = new List(); 
includedActivities.Add(Java.Lang.Class.FromType(typeof(MainActivity))); 
LauncherButton.InitForapp(this, includedActivities,  LauncherButton.ActivitiesTargetingMethod.Inclusive);
  7. Because the
    BlackBerry Dynamics Launcher
     requires authentication, add the following authorization code to the appropriate place in your app that authenticates users. Use
    true
     or
    false
     when appropriate. 
    HostingApp.Instance.SetAuthorized (true);