1. Integración binaria

Integre el SDK NFC Wallet para Android

Use esta guía para agregar las bibliotecas del SDK NFC Wallet a su Android aplicación de cartera digital.

Configuraciones compatibles

La última versión del SDK NFC Wallet para Android admite las siguientes configuraciones para esta integración:

• Versión de Android: 8.1 a 16.0
• Arquitectura de CPU (ABI): armeabi-v7a, arm64-v8a

Las versiones compatibles de Android son específicas de la versión del SDK. Para conocer el estado de compatibilidad más reciente, consulte Compatibilidad con el sistema operativo móvil.

Copie los archivos AAR

Obtenga los archivos AAR del SDK desde Entregables.

Cópielos en una carpeta dedicada de su proyecto. Por ejemplo:

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

NFC Wallet SDK se llamaba anteriormente TSH Pay SDK.

Algunas distribuciones todavía usan TSHPaySDK-... como prefijo del nombre de archivo AAR.

Configurar repositorios

Agregue la carpeta como un repositorio Maven local usando 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)

Habilitar divisiones ABI

Habilite las divisiones ABI para reducir el tamaño del APK (un APK por ABI). Consulte Compilar varios APK.

Agregar dependencias

Declare en dependencias:

• AAR de NFC Wallet
• dependencias de bibliotecas externas requeridas:

  • JNA (Java Native Access)

app/build.gradle

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

dependencies {
    // SDK NFC Wallet (los nombres de archivo AAR aún pueden comenzar con "TSHPaySDK")
    debugImplementation(name: "TSHPaySDK-dev-${nfcWalletSdkVersion}", ext: "aar")
    releaseImplementation(name: "TSHPaySDK-release-${nfcWalletSdkVersion}", ext: "aar")

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

    // Aplicación multidex para evitar cualquier problema de tamaño.
    implementation libs.multidex
}

Se requiere JNA 5.17.0 o posterior para admitir dispositivos que usan páginas de memoria de 16 KB.

Si usa notificaciones push (FCM o HMS Push Kit), agregue las dependencias requeridas. Consulte Configurar proveedor de push.

Verificar la compilación

El proyecto ahora debería estar listo para sincronizarse y compilarse.

1. Sincronice Gradle.
2. Compile la dev variante.

Debe cumplir con los requisitos del nivel de API objetivo de Google Play para nuevas versiones o versiones actualizadas de aplicaciones de billetera digital. Consulte Cumpla con el requisito del nivel de API objetivo de Google Play.