1. バイナリ統合

Android向けNFC Wallet SDKを統合する

このガイドを使用して、NFC Wallet SDKライブラリをAndroidに追加します デジタルウォレットアプリケーション.

対応構成

Android向け最新のNFC Wallet SDKは、この統合に対して次の構成をサポートしています:

• Androidバージョン: 8.1 ～ 16.0
• CPUアーキテクチャ（ABI）: armeabi-v7a, arm64-v8a

サポートされるAndroidバージョンはSDKリリースごとに異なります。最新の互換性状況については、 モバイル OS の互換性.

AARファイルをコピーする

SDKのAARファイルを取得します 提供物.

それらをプロジェクト内の専用フォルダにコピーします。例:

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

NFC Wallet SDKは以前、 TSH Pay SDK.

と呼ばれていました。まだ一部の配布物では TSHPaySDK-... をAARファイル名のプレフィックスとして使用しています。

リポジトリを設定する

以下を使用して、そのフォルダをローカルのMavenリポジトリとして追加します 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）

build.gradle

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

ABI分割を有効にする

APKサイズを削減するためにABI分割を有効にします（ABIごとに1つのAPK）。参照: 複数のAPKをビルドする.

依存関係を追加する

依存関係に宣言します:

• NFC Wallet AAR
• 必要な外部ライブラリの依存関係:

  • JNA（Java Native Access)

app/build.gradle

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

dependencies {
    // NFC Wallet SDK（AARファイル名は引き続き "TSHPaySDK" で始まる場合があります）
    debugImplementation(name: "TSHPaySDK-dev-${nfcWalletSdkVersion}", ext: "aar")
    releaseImplementation(name: "TSHPaySDK-release-${nfcWalletSdkVersion}", ext: "aar")

    // SDKの依存関係
    // JNA
    implementation(libs.jna) { artifact { type = 'aar' } }
    
    // FCM - Googleプッシュ通知
    implementation platform(libs.firebase.bom)
    implementation libs.firebase.messaging
    implementation libs.firebase.analytics

    // サイズ問題を防ぐためのマルチデックスアプリケーション。
    implementation libs.multidex
}

16 KBメモリページを使用するデバイスをサポートするには、JNA 5.17.0以降が必要です。

プッシュ通知（FCMまたはHMS Push Kit）を使用する場合は、必要な依存関係を追加してください。参照: プッシュプロバイダーを設定する.

ビルドを確認する

これでプロジェクトは同期およびコンパイルの準備が整いました。

1. Gradleを同期します。
2. をビルドします。 dev バリアント。

新規または更新されたデジタルウォレットアプリのリリースでは、Google Playの対象APIレベル要件に準拠する必要があります。参照: Google Playの対象APIレベル要件を満たす.