Install the SDK (manual)

Download

Install

  1. Download the components from above file.
  2. For the Miura reader, drag and drop mpos.android.core.aar, mpos.android.ui.aar,
    mpos.java.accessories.miura.jar, mpos.android.comlinks.bluetooth.aar
    and mpos.java.comlinks.tcp.jar to the "libs" folder of your project.

  3. The SDK requires a bunch of 3rd-party libraries, which are all available through Maven Central. Add them in the dependencies section of your build.gradle:
    
    dependencies {
        // Add the *.aar wildcard to include any Android libraries in the libs folder
        implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
        // Kotlin
        implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.3.20'
    
        // Google services
        implementation 'com.google.android.gms:play-services-vision:10.2.1'
    
        // Android support libraries
        implementation 'com.android.support:appcompat-v7:28.0.0'
        implementation 'com.android.support:cardview-v7:28.0.0'
        implementation 'com.android.support:support-v4:28.0.0'
        
        implementation 'com.squareup:otto:1.3.5'
        implementation 'com.squareup.okhttp:okhttp:2.7.4'
        implementation 'com.parse.bolts:bolts-android:1.2.1'
        implementation 'com.fasterxml.jackson.core:jackson-databind:2.5.0'
        implementation 'com.couchbase.lite:couchbase-lite-android:1.4.0'
        implementation 'com.couchbase.lite:couchbase-lite-android-forestdb:1.4.0'
    }
    

    Alternatively you can add the local libs directory as a repository in the repositories section in your build.gradle. That will let you specify the SDK libraries similar to the regular integration instructions.

    repositories {
        mavenCentral()
        flatDir name: 'localRepository', dirs: 'libs'
    }
    
  4. For version 2.45.0 and above you will need to make sure the app support Java 8 features by setting the compatibility levels:
    android{
    
        ...
    
        compileOptions {
            sourceCompatibility = 1.8
            targetCompatibility = 1.8
        }
    }
    
  5. Make sure to update your AndroidManifest.xml to enable a larger heap size by setting android:largeHeap="true". This is required to accommodate for situations where an update of the terminals is required and bigger chunks of data are requested and transferred.
        <application
            [...]
            android:largeHeap="true">
                [...]
        </application>