1. Binary integration

Integrate the NFC Wallet SDK for Android

Use this guide to add NFC Wallet SDK libraries to your Android digital wallet application.

Supported configurations

Latest NFC Wallet SDK for Android supports the following configurations for this integration:

• Android version: 8.1 to 16.0
• CPU architecture (ABI): armeabi-v7a, arm64-v8a

Supported Android versions are SDK-release specific. For the latest compatibility status, see Mobile OS compatibility.

Copy the AAR files

Get the SDK AAR files from Deliverables.

Copy them into a dedicated folder in your project. For example:

./dependencies
 ├── TSHPaySDK-dev-[version].[qualifier].aar
 └── TSHPaySDK-release-[version].[qualifier].aar

NFC Wallet SDK was previously named TSH Pay SDK.

Some deliveries still use TSHPaySDK-... as the AAR filename prefix.

Configure repositories

Add the folder as a local Maven repository using flatDir.

Groovy (settings.gradle)

settings.gradle

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://developer.huawei.com/repo/' }
        flatDir { dirs "$rootDir/dependencies" }
    }
}

Groovy (root build.gradle)

Enable ABI splits

Enable ABI splits to reduce APK size (one APK per ABI). See Build multiple APKs.

Add dependencies

Declare in depencies:

• NFC Wallet AARs
• required external libraries dependencies:

  • JNA (Java Native Access)

app/build.gradle

def nfcWalletSdkVersion = "[version].[qualifier]"

dependencies {
    // NFC Wallet SDK (AAR filenames can still start with "TSHPaySDK")
    debugImplementation(name: "TSHPaySDK-dev-${nfcWalletSdkVersion}", ext: "aar")
    releaseImplementation(name: "TSHPaySDK-release-${nfcWalletSdkVersion}", ext: "aar")

    // SDK Dependency
    // JNA
    implementation(libs.jna) { artifact { type = 'aar' } }
    
    // FCM - Google push notifications
    implementation platform(libs.firebase.bom)
    implementation libs.firebase.messaging
    implementation libs.firebase.analytics

    // Multi-dex application to prevent any size issue.
    implementation libs.multidex
}

JNA 5.17.0 or later is required to support devices using 16 KB memory pages.

If you use push notifications (FCM or HMS Push Kit), add the required dependencies. See Configure push provider.

Verify the build

The project should be now ready to be synced and compiled.

1. Sync Gradle.
2. Build the dev variant.

You must comply with Google Play target API level requirements for new or updated digital wallet application releases. See Meet Google Play's target API level requirement.