Technical Guide

Suite Installer

The BlueFletch Suite Installer is an application to assist clients in installing the BlueFletch Enterprise product line. This application will download, install, and if desired, start BlueFletch Enterprise products. The major benefit of this application is to give application permissions, and it will do all the work in the background (silently).

Note: Suite Installer is currently available and supported on Zebra devices only.

Flow A - Downloaded Config File

This flow allows for installing a configuration file that contains the appropriate commands for installing BlueFletch Enterprise applications.

  1. Install the Suite Installer using your favorite MDM.

  2. Invoke the Silent Initialzation.

  3. Install a Suite JSON file.

  4. Invoke the Silent Install.

Installation

Get the APK from BlueFletch and install to your device using your MDM.

Example ADB Command

adb install suiteinstaller-1.0.1.apk

Silent Initialzation

Invoke the application with the following information:

Package: com.bluefletch.ems.suite.installer Class: com.bluefletch.ems.suite.installer.SilentActivity

Example ADB Command

adb shell am start -n com.bluefletch.ems.suite.installer/com.bluefletch.ems.suite.installer.SilentActivity

Example AirWatch Command

mode=explicit,action=android.action.intent.MAIN,package=com.bluefletch.ems.suite.installer,class=com.bluefletch.ems.suite.installer.SilentActivity,broadcast=false

Install a Suite JSON file

Install a Suite.JSON file to this location:

/sdcard/Android/data/com.bluefletch.ems.suite.installer/files/emssuite/suite.json

Invoke the Silent Install

Invoke the application with the following information:

Package: com.bluefletch.ems.suite.installer Class: com.bluefletch.ems.suite.installer.SilentActivity Extras: action=install

Example ADB Command

adb shell am start -n com.bluefletch.ems.suite.installer/com.bluefletch.ems.suite.installer.SilentActivity -e action install

Example AirWatch Command

mode=explicit,action=android.action.intent.MAIN,package=com.bluefletch.ems.suite.installer,class=com.bluefletch.ems.suite.installer.SilentActivity,extraString=action=install,broadcast=false

Example SOTI Command

sendintent -a "intent:#Intent;action=android.intent.action.MAIN;component=com.bluefletch.ems.suite.installer/com.bluefletch.ems.suite.installer.SilentActivity;S.action=install;end;"

Flow B - Pass Configuration as URL

This flow allows for hosting the configuration file on a server and having the Suite Installer first download the configuration, then install BlueFletch Enterprise applications.

  1. Install the Suite Installer using your favorite MDM.

  2. Invoke the Silent Install passing the Suite JSON as URL Parameter.

Invoke the Silent Install

Invoke the application with the following information:

Package: com.bluefletch.ems.suite.installer Class: com.bluefletch.ems.suite.installer.SilentActivity Extras: url=URL POINTING TO A Suite JSON File

Example ADB Command

adb shell am start -n com.bluefletch.ems.suite.installer/com.bluefletch.ems.suite.installer.SilentActivity -e url https://somewhere.com/suite.json

Example AirWatch Command

mode=explicit,action=android.action.intent.MAIN,package=com.bluefletch.ems.suite.installer,class=com.bluefletch.ems.suite.installer.SilentActivity,extraString=url=https://somewhere.com/suite.json,broadcast=false |

Flow C - Install individual APKs

This flow allows for installing individual BlueFletch Enterprise product APKs, but it uses a URL to point to the APK hosted on a download server.

  1. Install the Suite Installer using your favorite MDM.

  2. Invoke the Silent Install using a File parameter that points to an APK.

Invoke the Silent Install

Invoke the application with the following information:

Package:: com.bluefletch.ems.suite.installer Class: com.bluefletch.ems.suite.installer.SilentActivity Extras: file=URL POINTING TO APK TO INSTALL

Example ADB Command

adb shell am start -n com.bluefletch.ems.suite.installer/com.bluefletch.ems.suite.installer.SilentActivity -e file https://somewhere.com/this.apk

Example AirWatch Command

mode=explicit,action=android.action.intent.MAIN,package=com.bluefletch.ems.suite.installer,class=com.bluefletch.ems.suite.installer.SilentActivity,extraString=file=https://somewhere.com/this.apk,broadcast=false

Configuration

Base Configuration

Field
Description

version

Free Formatted Configuration Version, informational only.

files

A collection of File Objects. Required

File Object

Field
Description

url

Download url for the Application. Required

version

Version of the Package to install. Optional

package

Name of the Package. Optional (required for uninstall feature)

uninstall

boolean indicating if should uninstall the package (defaults to false)

intent

Intent object describing the intent to fire once application is installed. Optional

Intent Object

Field
Description

action

Package Action to invoke. Required

package

Name of the Package. Required

class

Class name to invoked. Required

Example Configuration

{
  "version": "lastest-2020-12-12",
  "files": [
      {
         "package" : "io.optiko.agent",
         "uninstall": true
       },
      {
          "url": "https://www.somewhere.com/apk/supportApplication-5.3.3-prod.apk",
          "version" : "5.3.3",
          "package" : "com.bluefletch.ems.support",
          "intent" : {
              "action": "android.intent.action.MAIN",
              "package": "com.bluefletch.ems.support",
              "class" : "com.bluefletch.ems.support.features.ui.hidden.SilentInitActivity"
          }
      },
      {
          "url": "https://www.somewhere.com/apk/emsMessaging-2.3.1.apk",
          "version" : "2.3.1",
          "package" : "com.bluefletch.ems.messaging"
      },
      {
          "url": "https://www.somewhere.com/apk/emsauth_okta-1.3.7.apk",
          "version" : "1.3.7",
          "package" : "com.bluefletch.ems.auth"
      },
      {
          "url": "https://www.somewhere.com/apk/bluelauncher-production-2.9.2.apk",
          "version" : "2.9.2",
          "package" : "com.bluefletch.launcher",
          "intent" : {
              "action": "android.intent.action.MAIN",
              "package": "com.bluefletch.launcher",
              "class" : "com.bluefletch.launcher.Launcher"
          }
      }
  ]
}js
PreviousSuite InstallerNextRelease Notes

Last updated