Skip Navigation

Implement the 
BlackBerry Dynamics Launcher

You have the option to implement the 
BlackBerry Dynamics Launcher
, an intuitive front-end UI that makes it easy for device users to access and modify settings for 
BlackBerry Dynamics
 apps. For more information, see the documentation for the BlackBerry Dynamics Launcher Framework.
To implement the 
BlackBerry Dynamics Launcher
, you add the 
BlackBerry Dynamics Launcher
 button to an activity and include its authentication logic in the appropriate place in your app.
  1. Download the 
    BlackBerry Dynamics Launcher
     software from BlackBerry Developer Downloads.
  2. Unzip the packages.
  3. In your IDE, load the bindings into the desired projects. For each project, right-click 
    References
     and click 
    Edit References
     to reference the Launcher project (
    AndroidLauncherBinding.dll
    ).
  4. Verify that the 
    AndroidLauncherBinding
     project references the following 
    Android
     support packages. If they are not present, add them to the 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 that you want it to appear on. The 
    BlackBerry Dynamics Launcher
     can be initialized using either an inclusive or exclusive list of activities. If an inclusive list is used, the 
    BlackBerry Dynamics Launcher
     is shown only on the included activities.
    In this example, the 
    BlackBerry Dynamics Launcher
     is only added to the main activity:
    List includedActivities = new List(); includedActivities.Add(Java.Lang.Class.FromType(typeof(MainActivity))); LauncherButton.InitForapp(this, includedActivities, LauncherButton.ActivitiesTargetingMethod.Inclusive);
  7. Add the following authorization code to the appropriate place in your app that authenticates users. Use 
    true
     or 
    false
     as appropriate.
    HostingApp.Instance.SetAuthorized (true);