Android SDK

Download the Matching Engine Android SDK to create applications for your device.

Version: 1.1
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.

Prerequisites

  • 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 {
       google()
       jcenter()
   }
   dependencies {
       classpath 'com.android.tools.build:gradle:3.4.0'
       classpath "com.google.protobuf:protobuf-gradle-plugin:0.8.8"

       // 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 local.properties 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()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
def artifactory_user = properties.getProperty("artifactory_user")
def artifactory_password = properties.getProperty("artifactory_password")

project.ext.grpcVersion = '1.20.0'
project.ext.matchingengineVersion = '2.1.0'
project.ext.melVersion = '1.0.11'

Step 4: Add the MobiledgeX repository.

allprojects {
   apply plugin: 'com.jfrog.artifactory'
   apply plugin: 'maven-publish'
   repositories {
       google()
       jcenter()
       mavenLocal()
       maven {
           credentials {
               // Create these variables in local.properties if you don't have them.
               username artifactory_user
               password artifactory_password
           }
           url "https://artifactory.mobiledgex.net/artifactory/maven-releases/"
       }
   }
}

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.