|
| 1 | +# Mirrorfly Sample App |
| 2 | + |
| 3 | +## Overview |
| 4 | +Our sample app provides basic UI integrated with latest Mirrorfly SDK where you can customize and build your own app easily. |
| 5 | + |
| 6 | +## Before getting started |
| 7 | + |
| 8 | +This section shows you the prerequisites you need for testing **Mirrorfly Sample App**. |
| 9 | + |
| 10 | +### Requirements |
| 11 | +The minimum requirements to run the Sample App: |
| 12 | + |
| 13 | +```groovy |
| 14 | +- Android Lollipop 5.0 (API Level 21) or above |
| 15 | +- Java 7 or higher |
| 16 | +- Gradle 4.1.0 or higher |
| 17 | +``` |
| 18 | +> **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. |
| 19 | +
|
| 20 | +## Getting started |
| 21 | +This section explains the steps you need to take before testing the sample app. |
| 22 | + |
| 23 | +**Step 1:** Create a new project or Open an existing project in Android Studio |
| 24 | + |
| 25 | +**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 <a href="https://docs.gradle.org/6.8/release-notes.html#dm-features" target="_self">this release note</a> to learn more about updates to Gradle. |
| 26 | + |
| 27 | +```gradle |
| 28 | +dependencyResolutionManagement { |
| 29 | + repositories { |
| 30 | + mavenCentral() |
| 31 | + maven { |
| 32 | + url "https://repo.mirrorfly.com/release" |
| 33 | + } |
| 34 | + } |
| 35 | +} |
| 36 | + ``` |
| 37 | + |
| 38 | +**Step 3:** Add the following dependencies in the app/build.gradle file. |
| 39 | + ```gradle |
| 40 | + apply plugin: 'com.android.application' |
| 41 | +
|
| 42 | +android { |
| 43 | + buildFeatures { |
| 44 | + viewBinding true |
| 45 | + } |
| 46 | +
|
| 47 | + compileOptions { |
| 48 | + sourceCompatibility JavaVersion.VERSION_1_8 |
| 49 | + targetCompatibility JavaVersion.VERSION_1_8 |
| 50 | + } |
| 51 | +} |
| 52 | +
|
| 53 | +dependencies { |
| 54 | + implementation 'com.mirrorfly.sdk:MirrorFlySDK:7.13.0' |
| 55 | +} |
| 56 | + ``` |
| 57 | + |
| 58 | +**Step 4:** Add the below line in the gradle.properties file, to avoid imported library conflicts. |
| 59 | + ```gradle |
| 60 | + android.enableJetifier=true |
| 61 | + ``` |
| 62 | + |
| 63 | +**Step 5:** Open the AndroidManifest.xml and add below permissions. |
| 64 | + ```xml |
| 65 | + <uses-permission android:name="android.permission.INTERNET" /> |
| 66 | + ``` |
| 67 | +**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 <a href="https://console.mirrorfly.com/" target="_self">MirrorFly console</a>, and you can get it from there. |
| 68 | + ```gradle |
| 69 | + debug { |
| 70 | + buildConfigField 'Boolean', 'IS_QA_BUILD', 'true' |
| 71 | + buildConfigField 'String', 'LICENSE', '"Please enter your License key"' // add your license key |
| 72 | + buildConfigField 'String', 'WEB_CHAT_LOGIN', '"https://webchat-preprod-sandbox.mirrorfly.com/"' |
| 73 | + buildConfigField "String", "SUPPORT_MAIL", '"[email protected]"' |
| 74 | + resValue("string", "app_name", "UI Kit") |
| 75 | + shrinkResources false |
| 76 | + debuggable true |
| 77 | + minifyEnabled false |
| 78 | + signingConfig signingConfigs.config |
| 79 | + proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' |
| 80 | + } |
| 81 | +``` |
| 82 | +After saving your build.gradle file, click the Sync button to apply all the changes. |
0 commit comments