Creating a Configuration

User Guide: Enterprise Launcher Tab

Overview

The Enterprise Launcher tab is where to go to manage the home screen for rugged devices, specifically for use in a shared device model. Here the user will be able to edit or delete their Launcher configurations, download a configuration to the devices by scanning the QR Code, and send notifications to devices.

Creating A Configuration

BEST PRACTICE TIPS : Multiple configurations can be created for the organization. These configurations can be edited either on the BlueFletch Portal, on an IDE, or in a text editor. If configurations are built within an IDE or text editor, copy and paste the configs into the raw config editor on the Portal and be sure to update configuration versions and include descriptions for updates.

1. Navigate to Enterprise Launcher and select Configurations. Click NEW CONFIGURATION in the top right corner.
2. Enter a name and description for the configuration. Edit the body of the configuration using the menu provided, and click SAVE.

Viewing the Raw Configuration

The raw configuration file can be viewed at any time during the configuration process by clicking VIEW RAW CONFIG at the bottom of the window. The configuration can be edited in this mode or you can return to the guided editing window by clicking HIDE RAW CONFIG.

Customizable Sections

More information about any of the fields within any tab can be viewed in the Launcher Configuration Documentation.

General

The General tab is where the config version and license can be specified for this specific configuration.

Settings

The Settings tab is used to configure key values that control various processes of the device.

Layouts

The Layouts tab is used to specify which applications, folders and shortcuts are viewed based upon which user is logged in. Within each type of user, specifications for which apps are available can be set. Applications, folders and shortcuts can be created by clicking either ADD APPLICATION, ADD SHORTCUT, or ADD FOLDER. Once a folder is created, applications can be placed inside of it by editing the folder and clicking ADD APPLICATION.

Group Inclusion

The Group Inclusion tab is where an admin can control which applications the logged in user has access to. Each type of user's collection of applications can be toggled by selecting the boxes beneath that type of user. Group names can be changed by clicking the EDIT NAME button next to each group. A Group can be removed by clicking DELETE at the bottom of any specific group.

Intents

The Intents tab allows the admin to specify custom intents that are set to fire at different points in device usage. Intents can be set to fire at login, logout, boot, uncradle, cradle, and screen on. An intent can be added to a device event by clicking ADD CUSTOM INTENT and can be removed by clicking REMOVE located at the bottom of any intent.

Themes

The Themes tab allows the admin to set themes for the device such as the logo, theme colors, and wallpaper.

Authorization

The Authorization tab allows the admin to specify which means of authorization the device will use. More information about authorization can be found in the Authorization Documentation.

Support

The Support tab allows the admin to specify various values of the Support Tool. These values give the admin more control over the device being used such as alarm setting for low storage, alarm settings for low battery, and find me events.

Patterns

The Patterns tab allows the admin to specify configurations for associating search text with applications. If the search text matches the configured regex pattern, the application specified will be displayed, and could also specify the intent and extras that will be passed to the app when the search result is tapped. A pattern can be added by clicking ADD PATTERN located at the bottom of the page. A pattern can be removed by clicking REMOVE located at the bottom of any pattern card.

Keyboard

The Keyboard tab allows the admin to set certain specifications regarding the device keyboard. These include haptic feedback, big button text, keyboard layout, and key previews. For examples of all keyboard settings view the Keyboard Documentation.

Browser

The Browser tab allows the admin to set specifications regarding the device browser, such as show url, show title, allow cookie preview, and browser orientation.

Additional

The Additional tab allows the admin to specify certain package to disable within the device, any extended attributes to include, and notification broker info.

Disable Packages

The Disable Packages section allows the admin to specify certain packages to be disabled in the device by entering the names of packages. A package to disable can be added by clicking ADD FIELD and can be removed by clicking the minus button located to the right of any included package.

Extended Attributes

The Extended Attributes sections can be used to specify key-value pairs that customers can use to provide additional custom settings. An extended attribute can be added by clicking ADD EXTENDED ATTRIBUTE and can be removed by clicking REMOVE.

Notifications

The Notifications section can be used to specify Broker objects to connect to the messaging application in the device. During Launcher boot process, Launcher will communicate with the Messaging application to start. Then, it will register the MQTT Brokers, per configuration values. If "Enable Notifications Always On" is true, the MQTT Broker will be connected. A Broker object can be added by clicking ADD BROKER OBJECT and can be removed by clicking REMOVE located at the bottom of any Broker object card.

Secure Notifications

The Secure Notifications feature is a custom notification tray to be used as a replacement for the default Android System notification tray. This feature will allow device administrators to lock-down the notifications display and give them the ability to control which notifications are presented to the user. The "Whitelist" and "Blacklist" fields contain a list of packages to either suppress from display notifications or allow them to display notifications. A package can be added to either list by clicking ADD PACKAGE TO BLACKLIST or ADD PACKAGE TO WHITELIST. A package can be deleted by clicking the delete icon located to the right of any package.

Launcher Config