SOTI

There are two ways to set up the BlueFletch app suite in SOTI, either via sideloading the APKs or via managed Google Play store. This guide will walk through how to set things up both ways in case you have a preference.

Option 1: Sideloading APKs as "Packages"

Step 1: Create Application Package

IMPORTANT: It is recommended to create separate packages for each application. If all apps are in the same SOTI package, and you deploy an update to one of the apps, all of the apps will be updated.

1. First, you will need the APK files to upload into your SOTI Console. You can get the APKs for the different BlueFletch apps via the BlueFletch Portal, under "Admin" > "Downloads". Note: If you do not have access to the BlueFletch Portal, contact the BlueFletch Sales Team.

2. Create a new package within the SOTI Mobicontrol console.

3. Give the new package a title (i.e. "BlueFletch Enterprise") and fill in the minimum/maximum OS versions (Android 7+).

4. On the Files tab of the package, select the "+" button to open the "Add Files" screen.

5. On the Add Files screen, in the "General Details" section, open the dropdown menu for "Add Type" and select "APK".

6. In the "File Upload" section, press Browse File and select one of the APKs that you downloaded in step 1.1 above. 👉

7. Save the file and then you will be brought back to the package files screen.

8. Repeat steps 1.4 through 1.7 for each of the APKs that you wish to install as part of this package.

9. Once you have uploaded all the BlueFletch APKs that you want to install, proceed to the "Scripts" screen.

Step 2: Adding Post-Install Scripts

1. For the Device ID app, the Support Agent and the Launcher, there are post-install scripts that can be added the packages to automatically start them up. Follow the instructions below to add the required post-install script to each of these apps' packages.

2. On the "Scripts" tab of the new package, select the "+" button to add a new script.

3. Select "Post-Install" from the "Execution Step" dropdown menu.

4. Copy the following lines into the script editor: Start the Device ID app so it can get the device serial number:

   Copy

   sendintent -a "intent:#Intent;action=com.bluefletch.ems.deviceid.ACTION_INIT;component=com.bluefletch.ems.deviceid/com.bluefletch.ems.deviceid.MainActivity;end;"

   Start the Support Agent Silently:

   Copy

   sendintent -a "intent:#Intent;action=android.intent.action.MAIN;component=com.bluefletch.ems.emm.support/com.bluefletch.ems.emm.support.features.ui.hidden.SilentInitActivity;end;"

   Start up the Launcher:

   Copy

   sendintent -a "intent:#Intent;action=android.intent.action.MAIN;component=com.bluefletch.ems.emm.launcher/com.bluefletch.ems.emm.launcher.Launcher;end;"

1. Click the "Save" button.

2. Click the "Next" button.

3. Select "Publish".

Step 3: Create a Package for the Configuration File

1. Create a new package within the SOTI Mobicontrol console.

2. Give the new package a title (i.e. "BlueFletch Enterprise") and fill in the minimum/maximum OS versions (Android 7+).

3. On the Files tab of the package, select the "+" button to open the "Add Files" screen.

4. Make sure the "Add type" is "File".

5. Upload the launcher.json file. Note: Your BlueFletch Sales Engineer will help you set up your first launcher.json configuration file.

6. Set the file path to:

   Copy

   %sdcard%/Download/ems/

7. Select the option to "Replace The File if File is Older or Non-Existent".

   

8. Select "Save".

9. Select "Next".

10. Select "Publish".

Step 4: Create a Profile for the Package(s)

1. From the menu, select "Profiles".

2. Select "New Profile" in the top right corner.

3. Select "Android" > "Work Managed".

4. Fill in the profile name and other fields.

5. Select the "Packages" tab.

6. Select the "+" buton in the top right and then locate the packages you created for this deployment, check the box next to each of the ones you want to add to this profile. Then select "Add to Profile" in the bottom right.

7. Save and Assign and select the correct group to deploy the apps to.

Option 2: Deploy via Google Play

Step 1: Add the apps to your SOTI Console

NOTE: BlueFletch apps are private Google Play apps. You will need to provide your Managed Google Play organization ID to your BlueFletch Sales Team so that they can share the applications with your Managed Google Play account.

1. Once the BlueFletch apps have been shared with your Managed Google Play account, go to "Policies" > "Apps" > "New App Policy"

2. Select "Android Enterprise".

3. Set a Policy Name

4. Select the "Apps" tab

5. Press the "+" button in the top-right

6. Select "Managed Google Play"

7. Searching for "BlueFletch" (with the quotes included, like in the screenshot below) will bring up all of the BlueFletch apps that have been shared with your Managed Google Play organization.

8. Select one of the applications and then press the "Select" button on it to add it to your SOTI.

9. You will be brought back to the "Select Apps" screen within SOTI, and the application should appear on the list.

10. Repeat steps 6 through 9 for each of the BlueFletch apps.

Step 2: Select a Release Track for Each App

1. Select the Three Dot menu to the right of the app within SOTI's App Policy "Select Apps" dialogue.

2. Press "Configure".

3. Select the "Installation Options" tab.

4. In the "Release Track" dropdown, select the latest version.

5. Select "Save" in the bottom Right corner.

6. Repeat step 2.1 through step 2.5 above for each BlueFletch App.

Step 3: Add the Managed Configuration for Launcher

1. For the BlueFletch Launcher application, select the Three Dot menu to the right of the app within SOTI's App Policy "Select Apps" dialogue.

2. Press "Configure".

3. On the Managed App Config tab, Turn the slider on for "Enable Managed App Config".

4. Input the Organization ID, which can be found in the BlueFletch Portal under "Admin" > "Organization".

5. Input the URL and Checksum for the hosted Launcher.json configuration file. If you do not have this information, the BlueFletch Sales Team will help you with setting up your first BlueFletch configuration file.

6. Once you have updated the managed config, press "Save".

Step 4: Finalizing the App Policy

1. Within SOTI's App Policy "Select Apps" dialogue, select the checkbox next to each of the apps you would like to add to this policy.

2. Click the "Add" button.

3. Once the apps show up in the list of apps to be deployed by the policy, you can select "Save and Assign" to select a device group to deploy these applications to.