Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinefalse
typelist
printablefalse

Overview

The Launch APK is an optional service APK containing configurations for the Motive APK to use such as endpoints and Launch Server credentials. This APK allows for quick app configuration modifications without the need to build and update existing the Motive APK.

If a Launch APK is present on a device when a Motive app is ran, the app will configure itself using the configuration specified in the Launch APK. Otherwise, the Motive app will configure itself according to the AppConfig it contains.

Usage

  1. Open the LaunchService project inside Android Studio.

  2. Locate the file LaunchService\app\src\main\assets\service-config.json. This service-config by default is populated with endpoints pointing to Motive Cloud Services.

Code Block
{
  "clusters":
  [
    {
      "localizedTitle": {
        "text": "US"
      },
      "idServer": {
        "url": "https://id.storyflow.dev"
      },
      "launchServer": {
        "url":"https://ls-us.storyflow.dev",
        "clientId":"",
        "clientSecret":""
      },
      "storyflowApp": {
        "url": "https://app.storyflow.dev"
      },
      "storyflowApi": {
        "url": "https://api.storyflow.dev"
      }
    }
  ]
}

  1. Configure all fields to appropriate values dependent on your clients' setup

...

Building

  1. Navigate to Build

...

  1. > Generate Signed Bundle / APK…

...

 

2. Choose APK

...

3. Choose Create new… if going through first time setup, otherwise Choose existing… and re-use the key.

Note

The first password field refers to the Keystore’s password. The second field refers to the initial Key’s password.

The fields shown filled out are the necessary fields. Ensure these passwords are logged somewhere secure as you’ll require them during each APK build on either Android Studio, Unity, or through CLI.:

...

Note

Android Studio defaults to creating “keystore” files with extension .jks, rename this extension to .keystore. This is necessary as Unity does not recognize .jks files.

.jks and .keystore have no differences and operate the same.

...

5. Choose the Build Variant that you desire and select ONLY the V2 (Full APK Signature) checkbox:

...

6. Signed APK is now built! Use the toast notification to easily navigate to its output location.:

...

Note

If a signed build already exists, the build will not overwrite the previous build. You must manually delete/rename/move the previous build.

Related Articles

AppConfig.json Format

App Configuration and Startup

App Configuration Options