Mirrorfly Sample App

Overview

Our sample app provides basic UI integrated with latest Mirrorfly SDK where you can customize and build your own app easily.

Before getting started

This section shows you the prerequisites you need for testing Mirrorfly Sample App.

Requirements

The minimum requirements to run the Sample App:

- Android Lollipop 5.0 (API Level 21) or above
- Java 7 or higher
- Gradle 4.1.0 or higher

Note : If you're utilizing Chat SDK version 7.11.4 or higher, it's necessary to adjust the target SDK version to 34. This is due to the migration of Chat SDK to Android 14.

Getting started

This section explains the steps you need to take before testing the sample app.

Step 1: Create a new project or Open an existing project in Android Studio

Step 2: If using Gradle 6.8 or higher, add the following code to your settings.gradle file. If using Gradle 6.7 or lower, add the following code to your root build.gradle file. See this release note to learn more about updates to Gradle.

dependencyResolutionManagement {
        repositories {
            mavenCentral()
               maven {
                 url "https://repo.mirrorfly.com/release"
                 }
       }
}

Step 3: Add the following dependencies in the app/build.gradle file.

apply plugin: 'com.android.application'

android {
 buildFeatures {
     viewBinding true
 }

 compileOptions {
     sourceCompatibility JavaVersion.VERSION_1_8
     targetCompatibility JavaVersion.VERSION_1_8
 }
}

dependencies {
   implementation 'com.mirrorfly.sdk:MirrorFlySDK:7.13.0'
}

Step 4: Add the below line in the gradle.properties file, to avoid imported library conflicts.

android.enableJetifier=true

Step 5: Open the AndroidManifest.xml and add below permissions.

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

Step 6: To log in and run the app, you need to add the LICENCSE key in the app/build.gradle file. To generate the license key, you need to sign up in the MirrorFly console, and you can get it from there.

     debug {
         buildConfigField 'Boolean', 'IS_QA_BUILD', 'true'
         buildConfigField 'String', 'LICENSE', '"Please enter your License key"' // add your license key
         buildConfigField 'String', 'WEB_CHAT_LOGIN', '"https://webchat-preprod-sandbox.mirrorfly.com/"'
         buildConfigField "String", "SUPPORT_MAIL", '"[email protected]"'
         resValue("string", "app_name", "UI Kit")
         shrinkResources false
         debuggable true
         minifyEnabled false
         signingConfig signingConfigs.config
         proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
     }

After saving your build.gradle file, click the Sync button to apply all the changes.