This page describes how to make the Android application you want with Mojitok Sticker SDK.

Fundamentals

We introduce fundamentals of Mojitok Sticker SDK.

A app with Mojitok Sticker SDK can show the sticker to users by delivering the sticker ID and its path. A authorized user can request to show the target sticker by delivering the sticker ID.

Pre-built components

We introduce major components Mojitok Sticker SDK provides.

MJTBaseFragment

This is a view that can show and use the stickers curated or owned by user. in the keyboard area or the area desired by the developer.

MJTRTSFragment

This is a view that shows a sticker that matches the text entered by user.

SDKs

Official Mojitok Sticker SDK is here.

Overview

Use Mojitok Sticker SDK and provide interesting image messages to your chatting app ! This guide has setup manuals, download, demo app of Mojitok Sticker SDK.

Setup

It needs the conditions below for Mojitok Sticker SDK.

Android Minimum API Level
21 (Android 5.0 - Lolipop) or higher

Despite some Android devices take appropriate Android OS version, they may have wrong actions. We have reports these devices have operated abnormally because of Coroutine issue on Android 5.0.

Install using Gradle

You can install UIKit for Android through Gradle. Begin by opening the root build.gradle file and add the code blocks below:

Project build gradle setting

Add maven to the repository of your project/build.gradle.

The value of deploy-token is a unique token provided to customers individually.

project/build.gradle

buildscript {
    // how to securely provide API keys
    Properties properties = new Properties()
    def propertiesFile = project.rootProject.file('local.properties')
    if (propertiesFile.exists()) {
        properties.load(propertiesFile.newDataInputStream())
    }
    ext.gitLabDeployToken = properties.getProperty('gitLabDeployToken')

    repositories {
        google()
        mavenCentral()
    }
    
    ...
    
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()

        maven {
            //  mojitok-ui-android project id = 20979087
            url "https://gitlab.com/api/v4/projects/20979087/packages/maven"
            name "GitLab"
            credentials(HttpHeaderCredentials) {
                name = 'Deploy-Token'
                value = gitLabDeployToken
            }
            authentication {
                header(HttpHeaderAuthentication)
            }
        }
    }
}

project/local.properties

sdk.dir=/Users/{Your-account-name}/Library/Android/sdk
gitLabDeployToken={Unique-tokens-provided-for-each-company}

app/build.gradle

dependencies {

    ...

    implementation 'com.mojitok:mojitokuikit:1.2.3'
 
    ...
}

Install using .aar file

First, it needs to take Mojitok Sticker SDK that is a .aar file. Locate it on proper sub-path of Android project directory. Normally, the libs sub-directory in target project module is a appropriate location.

Open bulid.gradle file of the target module and reconstruct its dependencies. Following example shows how to declare the dependency in the build.gradle file for Mojitok Sticker SDK.

build.gradle

You can access following features if the process above is completed.

com.mojitok.mojitokcore.Mojitok
com.mojitok.mojitokuikit.ui.MJTBaseFragment
com.mojitok.mojitokuikit.ui.MJTRTSFragment
com.mojitok.mojitokuikit.ui.loadMojitokSticker

If you want to find more information for build environment, follow next guide.

Build environment for Mojitok Sticker SDK

Download

Install latest Mojitok Sticker SDK in the following link.

Mojitok Sticker SDK Release Folder

Demo App

The following link provides demo app and its source for Mojitok Sticker SDK.

MojitokSDK-Android-SampleApp

Mojitok Developer Guide

Documentation