Skip to main content

Installation

Provides API to retrieve additional information about the card from 3rd party vendor's system.

Requirements​

  • Device must be able to connect to the Internet.
  • Android version must be 6.0 (API level 23) or above.

Android Studio​

It is recommended to use Android Studio and Gradle to build the project.

Gradle Configuration​

MCD SDK should be added to the project as a standard Android dependency. SDK is hosted in a private Maven repository, so you need to configure build.gradle by setting the assigned URL and credentials.

Environments:

  • test - test environment
  • prod - production environment

Library Repository and Dependencies​

info

Nexus Repository credentials have changed when upgrading from Legacy version. Contact MeaWallet for new credentials.

build.gradle
repositories {
    maven {
        url 'https://nexus.ext.meawallet.com/repository/mcd-android-group/'

        credentials {
            username '<user>'
            password '<password>'
        }
    }
}

dependencies {
    debugImplementation 'com.meawallet:mcd-<environment>:<version>-debug'
    releaseImplementation 'com.meawallet:mcd-<environment>:<version>'
}

Configuration​

  1. Download mea_config.<issuer>.zip.

  2. Unzip the archive. Archive contains configuration file mea_config.

  3. Add mea_config to Android App resources res/raw folder. Library automatically loads configuration from app bundle during runtime, and throws an exception if configuration file is missing, broken or otherwise fails to load.

Library Repository and Dependencies (Legacy version 1.0.1 and older)​

build.gradle
repositories {
    maven {
        url 'https://nexus.ext.meawallet.com/repository/<repository>'

        credentials {
            username '<user>'
            password '<password>'
        }
    }
}

dependencies {
    debugImplementation 'com.meawallet:mcd-<user>-<environment>:<version>-debug'
    releaseImplementation 'com.meawallet:mcd-<user>-<environment>:<version>'
}

App Manifest​

It is not necessary to specify any permissions for SDK in AndroidManifest.xml file. A special marker tools:overrideLibrary can be used with uses-sdk declaration to override importing a library with minimum SDK version above application's minimum SDK version. Without such a marker manifest merger fails with an error. The marker allow users to select which libraries can be imported ignoring the minimum SDK version.

MCD SDK is using the following permissions that are merged with the app manifest file:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>