Integrate the BlackBerry Dynamics Launcher for Android

As of the BlackBerry Dynamics SDK for Android version 13.0, the BlackBerry Dynamics Launcher is now integrated with the SDK. Previously, you had to integrate a separate BlackBerry Dynamics Launcher Library (version 12.1 and earlier) to add the Launcher to your BlackBerry Dynamics apps. The Launcher is enabled by default, but you do have the option to disable it.

Take note of the following details and required actions for this new integration of the BlackBerry Dynamics Launcher:

Item

Details

New API classes
The integration of the BlackBerry Dynamics Launcher uses the following new API classes:
The new classes replace the following that were used for the previous integration of the Launcher:
  • com.good.launcher.LauncherButton
  • com.good.launcher.HostingApp
  • com.good.launcher.GDStateNotifier

The old APIs are still available and will be deprecated in a future release of the SDK.

Automatic start

By default, the BlackBerry Dynamics Launcher is enabled and starts automatically when the app is run.

If you want to disable the BlackBerry Dynamics Launcher, add the following value to assets/com.blackberry.dynamics.settings.json:

{
    "AutomaticLauncherManagement": false
}

Customizing the Launcher
You can control the behavior of the BlackBerry Dynamics Launcher using an instance of LauncherDelegate:
  • onSettingsCommand(Activity originActivity): Configure a settings page for the app. If you do not configure a custom settings page, the BlackBerry Dynamics Launcher includes a default settings page.
  • shouldShowButton(Activity activity): Control whether the Launcher button should display for a specified activity. By default, the button will display for all activities.
  • shouldShowCoachmark(): Control whether a screen demonstrating how to use the Launcher will display the first time the app is opened. By default, this feature is enabled.