Integration

Credentials

Add credentials in project's local.properties

# ========================= Mimi =========================
# Mimi Portal Access Credentials
mimiMavenUser=PORTAL_USERNAME
mimiMavenPassword=PORTAL_PASSWORD

# Client Credentials
# NOTE: The quotes are needed around value string
mimiClientID="CLIENT_ID"
mimiClientSecret="CLIENT_SECRET"
# ========================================================

Dependency

Add helper function to the end of root build.gradle file to get values from local.properties file:

//region Get ENV vars
def getBuildProperty(String localProperty, String environmentVariable, String orDefault = "undefined") {
    return getLocalProperty(localProperty) ?: System.getenv(environmentVariable) ?: orDefault
}

def getLocalProperty(String key) {
    Properties localProperties = new Properties()
    if (file("local.properties").exists()) {
        localProperties.load(file("local.properties").newDataInputStream())
    }
    return localProperties[key]
}
//endregion

Next, add mimi maven repo inside your repositories block.

• If your repositories block is inside project/build.gradle

allprojects {
    // Define Build properties
    ext {
        mimiMavenUser = getBuildProperty("mimiMavenUser", "PORTAL_USERNAME")
        mimiMavenPassword = getBuildProperty("mimiMavenPassword", "PORTAL_PASSWORD")
    }

    repositories {
        google()
        mavenCentral()

        // Mimi artifacts repository
        maven {
            url "https://api.integrate.mimi.io/files/sdk/android"
            credentials {
                username = "${mimiMavenUser}"
                password = "${mimiMavenPassword}"
            }
            authentication {
                basic(BasicAuthentication)
            }
        }
    }
}

• If your repositories block is inside project/settings.gradle

dependencyResolutionManagement {
    // Define Build properties
    ext {
        mimiMavenUser = getBuildProperty("mimiMavenUser", "PORTAL_USERNAME")
        mimiMavenPassword = getBuildProperty("mimiMavenPassword", "PORTAL_PASSWORD")
    }

    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()

        // Mimi artifacts repository
        maven {
            url "https://api.integrate.mimi.io/files/sdk/android"
            credentials {
                username = "${mimiMavenUser}"
                password = "${mimiMavenPassword}"
            }
            authentication {
                basic(BasicAuthentication)
            }
        }
    }
}

Finally inside the root build.gradle file add ext properties like below:

ext {
    mimiClientID = getBuildProperty("mimiClientID", "CLIENT_ID")
    mimiClientSecret = getBuildProperty("mimiClientSecret", "CLIENT_SECRET")
    // Define MSDK version here
    msdkVer = "10.2.0"
}

Inside app/build.gradle

• Add buildConfigField under defaultConfig:

android {
    ...

    defaultConfig {
        ...

        buildConfigField("String", "MY_CLIENT_ID", rootProject.ext.mimiClientID)
        buildConfigField("String", "MY_CLIENT_SECRET", rootProject.ext.mimiClientSecret)
    }
}

• Add mimi sdk under dependencies section inside your app's build.gradle file:

dependencies {
    // Include your other dependencies here...

    // Mimi SDK
    implementation "io.mimi:sdk:$rootProject.ext.msdkVer"
}

Sync/Make your project now so that all dependencies are downloaded and BuildConfig fields are generated

Init MSDK

Start MimiCore inside your custom Application class's onCreate(). For example, let's say your custom Application class is called MyApp. Then

import io.mimi.sdk.core.MimiConfiguration
import io.mimi.sdk.core.MimiCore

class MyApp : Application() {

    override fun onCreate() {
        super.onCreate()
        initializeMimiCore(this)
    }

    private fun initializeMimiCore(context: Context) {
        MimiCore.start(
                context = context,
                configuration = MimiConfiguration(),
                clientId = BuildConfig.MY_CLIENT_ID,
                clientSecret = BuildConfig.MY_CLIENT_SECRET
        )
    }
}

Note

First setup the function to only log while in debug mode:

private fun enableMimiSDKLogs() {
    io.mimi.sdk.core.util.Log.isEnabled = BuildConfig.DEBUG
}

Next, call this function just before initializing the MSDK (MimiCore.start() )

private fun initializeMimiCore(context: Context) {
    enableMimiSDKLogs()
    MimiCore.start(...)
}

Wire in Application class

Make sure MyApp is added to application tag inside AndroidManifest.xml

<application
    android:name=".MyApp" ...>

Add required permission declarations inside AndroidManifest.xml.

Skip if you already have them declared

<uses-permission android:name="android.permission.INTERNET" />