Android SDK: Setup

Prepare your Android project to consume the Ei Card Provider SDK (core) and the Digital Card Engine UI SDK. This page covers repositories, credentials, Gradle config, dependencies, and required permissions.

Requirements

Android: minSdk 29, compileSdk/targetSdk 35
Kotlin: 2.0.x (jvmTarget = 11)
Jetpack Compose (BOM 2024.04.01 or newer) for UI components
Network access in your app manifest

Repositories (including MeaWallet MCD)

Add the Google, Maven Central, and MeaWallet MCD Maven repos to settings.gradle.kts:

pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
    maven {
      url = uri("https://nexus.ext.meawallet.com/repository/mcd-android-group/")
      credentials {
        username = providers.gradleProperty("MEA_MAVEN_USERNAME").get()
        password = providers.gradleProperty("MEA_MAVEN_PASSWORD").get()
      }
    }
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://nexus.ext.meawallet.com/repository/mcd-android-group/")
      credentials {
        username = providers.gradleProperty("MEA_MAVEN_USERNAME").get()
        password = providers.gradleProperty("MEA_MAVEN_PASSWORD").get()
      }
    }
  }
}

Store credentials securely (for example, ~/.gradle/gradle.properties or CI secrets):

MEA_MAVEN_USERNAME={{MEA_MAVEN_USERNAME}}
MEA_MAVEN_PASSWORD={{MEA_MAVEN_PASSWORD}}

Module dependencies

Add to your app module build.gradle.kts:

dependencies {
  // Core SDK (data + API)
  implementation("com.paymentology:card_provider_sdk:1.0.0")

  // MeaWallet MCD (secure card images)
  // For dev/testing:
  implementation("com.meawallet:mcd-test:1.7.1")
  // For production, use your provisioned artifact:
  // releaseImplementation("com.meawallet:mcd-<user>-<environment>:<version>")

  // Digital Card Engine UI SDK
  // If consuming from this repo:
  implementation(project(":digital_card_engine_sdk_android"))
  // If consuming a published artifact:
  // implementation("com.paymentology:digital-card-engine-sdk-android:<version>")
}

Android and Compose configuration

android {
  compileSdk = 35
  defaultConfig { minSdk = 29 }

  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_11
    targetCompatibility = JavaVersion.VERSION_11
  }
  kotlinOptions { jvmTarget = "11" }

  buildFeatures { compose = true }
  composeOptions { kotlinCompilerExtensionVersion = "1.5.14" }
}

dependencies {
  implementation(platform("androidx.compose:compose-bom:2024.04.01"))
  implementation("androidx.compose.ui:ui")
  implementation("androidx.compose.material3:material3")
  implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.8.4")
}

Permissions

Ensure network permissions are declared in AndroidManifest.xml:

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

Verify setup

Sync Gradle.
Run a simple app build.
Call DigitalCardEngineSDK.initialize(context, token, env) (see the Initialize page).
If you plan to show secure card images, confirm the MCD artifact resolves and MeaCardData.initialize runs without errors.