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.

Download the

BlackBerry Dynamics Launcher

Bindings for .NET software from BlackBerry Developer Downloads.

In your IDE, load the NuGet binding packages into the desired projects. For each project, right-click

Dependencies

and click

Manage NuGet Packages...

to reference the Launcher binding. For more information, see Load bindings for a new project.

In your app, include the following packages:

using Com.Blackberry.Launcher;
using Com.Good.Launcher;

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:

var includedActivities = new List<Java.Lang.Class>
{
    Java.Lang.Class.FromType(typeof(MainActivity))
};
GDLauncher.InitForApplication(this, includedActivities, LauncherButton.ActivitiesTargetingMethod.Inclusive, this);

You can also use an initialization API for all activities:

GDLauncher.InitForApplication(this, this);

Implement ILauncherDelegate and pass it to InitForApplication. Optionally, override the default implementation.

// Override default interface implementation
void ILauncherDelegate.OnSettingsCommand()
{
    Toast.MakeText(this, $"Launcher version: {GDLauncher.Version}", ToastLength.Short).Show();
}

To get broadcast receivers to pass authorization events, ApplicationInit is mandatory before calling GDLauncher.InitForApplication in the application OnCreate method.

public override void OnCreate()
{
    base.OnCreate();

    GDAndroid.Instance.ApplicationInit(this);

    // Initialize launcher
    GDLauncher.InitForApplication(this, this);
}

Add the following authorization code to the appropriate place in your app that authenticates users. Use

true

false

as appropriate.

HostingApp.Instance.SetAuthorized (true);

Section:

Steps to get started with the BlackBerry Dynamics SDK

Implement the BlackBerry Dynamics Launcher

Implement the
BlackBerry Dynamics Launcher