Android SDK

Last Modified: 7/10/2020

The MobiledgeX Client Library enables an application to register and then locate the nearest edge cloudlet backend server for use. The client library also allows verification of a device's location for all location-specific tasks. Because these APIs involve networking, most functions will run asynchronously, and in a background thread.

The Matching Engine Android SDK provides everything required to create applications for Android devices.

Note: Devices without a supporting cellular network may use Wifi for development.


  • Android Studio 3.6.x installed
  • A device with API v.23 or higher (Android 6.0)
  • A SIM card from a supported carrier for initial application development is recommended; alternatively, if a supported carrier is not available, Wifi may be utilized

Download the Android SDK and libraries

Step 1: Create a login on to the Console. The creation of a login will automatically generate a user account and allows for access to Artifactory.

Note: With a login created, you may download the Android SDK library as well as upload a server image for installation on the edge network.

Step 2: In your top level Android Studio gradle project file, add the following artifactory plugin to the buildscript section.

buildscript {
  repositories {
  dependencies {
    classpath ''
    classpath ""
    // JFrog Artifactory:
    classpath "org.jfrog.buildinfo:build-info-extractor-gradle:latest.release"
    // NOTE: Do not place your application dependencies here; they belong
    // in the individual module build.gradle files

Step 3: Append the following two properties to the file. Additionally, you must include these two properties within your gradle file. Once the properties are added, specify a project level GRPC version, and the MobiledgeX SDK matchingEngine version.

Properties properties = new Properties()
def artifactory_user = properties.getProperty("artifactory_user")
def artifactory_password = properties.getProperty("artifactory_password")
project.ext.grpcVersion = '1.32.1'
project.ext.matchingengineVersion = '2.4.2'
project.ext.melVersion = '1.0.11'

Step 4: Add the MobiledgeX repository.

allprojects {
   apply plugin: 'com.jfrog.artifactory'
   apply plugin: 'maven-publish'
   repositories {
       maven {
           credentials {
               // Create these variables in if you don't have them.
               username artifactory_user
               password artifactory_password
           url ""

Step 5: In the application build.gradle project file, add the following to the dependencies section so that the MobiledgeX related libraries can be downloaded. Click sync gradle file if prompted by the Android Studio IDE.

dependencies {
   // ...
   implementation "com.mobiledgex:matchingengine:${matchingengineVersion}"
   implementation 'com.mobiledgex:mel:${melVersion}'
   implementation "io.grpc:grpc-okhttp:${grpcVersion}"
   implementation "io.grpc:grpc-stub:${grpcVersion}"
   implementation "io.grpc:grpc-protobuf-lite:${grpcVersion}"

Where to Go from Here

  • Access the MobiledgeX Android Library and APIs, here.
  • Need a sample App? Click here.
  • To learn how to use Docker to upload your application server, see this tutorial.