Launcher Class Reference

Class to manage and configure `BlackBerry Launcher`. More...

Description

The "Launcher" is a UX concept whereby an icon is displayed permanently on each screen, "floating" over the content. From the Launcher a user is able to launch other BlackBerry Dynamics apps, as well as take quick actions such as compose an email or schedule a meeting.

The Launcher will be automatically started, and present the floating Launcher Button for every Activity. Applications can control the behavior of Launcher by providing an instance of LauncherDelegate, or alternatively may disable Launcher completely by adding the following setting value to the file assets/com.blackberry.dynamics.settings.json:

{
  "AutomaticLauncherManagement": false
}

The Launcher includes an affordance to open a Settings page for the application. Applications may provide their own Settings implementation, by implementing the LauncherDelegate.onSettingsCommand(Activity) method. If an application does not provide its own implementation, a default one will be provided, which includes basic functionality such as changing the application password and uploading logs.

Static Public Member Functions
static void	setDelegate (@NonNull LauncherDelegate delegate)
	Set the LauncherDelegate. More...
static void	initForApplication (final Application context, final LauncherDelegate delegate)
	Initialize Launcher in the application. More...
static String	getVersion ()

Member Function Documentation

setDelegate()

static void setDelegate ( @NonNull LauncherDelegate  delegate )

static

This method should be called before BlackBerry Dynamics is initialized, ideally in the Application.onCreate() method, by any Application that wishes to control the Launcher.

initForApplication()

static void initForApplication ( final Application  context, final LauncherDelegate  delegate  )

static

The provided LauncherDelegate instance will be used to control the behavior of the Launcher.

Parameters

context	Application context
delegate	An instance of LauncherDelegate

getVersion()

static String getVersion ( )

static

Returns

The BlackBerry Dynamics runtime library version.