Skip Navigation

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.