Android

このガイドを使用して、を統合します Thales SDK Android マーチャントアプリケーションに。

配布パッケージ

SDK配布パッケージには以下が含まれます:

名前	説明
tmgsdk-debug-<version>-<release_date>.aar	Thales SDK のデバッグ用 AAR。
tmgsdk-release-<version>-<release_date>.aar	Thales SDK のリリース用 AAR。
demo	SDK の統合と使用方法を示すサンプルプロジェクト。
javadoc	SDK API ドキュメント。

依存関係

依存関係名	バージョン	説明
JNA	5.5.0	このライブラリは Thales SDK に同梱されたネイティブライブラリへアクセスするために使用されます。
AndroidX Biometric	1.1.0	このライブラリは Android デバイスでの生体認証に使用されます。

SDK v2.0.0 以降、OkHttp はもはや必須ではありません。

SDKを統合する

1. というフォルダを作成します libs プロジェクトディレクトリの下。

例 libs SDK AAR を含むフォルダ。

1. コピー tmgsdk-<variant>-<version>-<release_date>.aar へ libs フォルダ。

   variant は debug または release.
2. を開いてください app/build.gradle ファイルを開き、以下の依存関係を追加してください：

implementation 'androidx.biometric:biometric:1.1.0'
implementation 'net.java.dev.jna:jna:5.5.0@aar'
implementation fileTree(dir: 'libs', include: ['*.aar'])

SDKを構成する

• SDK v2.0.0 以降、アプリケーションは証明書の PIN 値を提供する必要がなくなりました。
• SDK v3.0.0 以降、SDK は Android Keyguard をサポートしなくなりました。

SDKのいかなるAPIを呼ぶ前にもThales SDKを構成してください。

を作成します TMGClientConfiguration 必要なパラメータで:

• アプリケーションコンテキスト
• サーバーURL
• サーバー証明書
• キー識別子

1. を作成します TMGClientConfiguration

オンボーディング中にサーバーURL、サーバー証明書、およびキー識別子を取得します。

Activity activity;
String serverUrl;
byte[] serverCertificate;
String keyIdentifier;
TMGClientConfiguration tmgClientConfiguration = new TMGClientConfiguration(activity, 
                                                                           serverUrl, 
                                                                           serverCertificate, 
                                                                           keyIdentifier);

2. 生体認証サポートの確認

デバイスが生体認証をサポートしているか確認します。

int biometricSupport = DeviceAuthenticationChecker.getBiometricsSupport(activity);
if (biometricSupport == BiometricsSupport.SUPPORTED) {
    // 現在のデバイスは生体認証をサポートしています。
}

3. を作成します VisaCTFHelper

Visa CTFおよびDAFのデバイスバインディング開始とトランザクション認証のためのヘルパーを作成します。

public void initVisaCTFHelper(@NonNull TMGClientConfiguration tmgClientConfiguration) {
    byte[] password = this.getUserPassword();
        VisaCTFHelper visaCTFHelper = TMGClient.getInstance().createVisaCTFHelper(tmgClientConfiguration);
    } catch (TMGClientException e) {
        // エラーを処理します。
    }
}

4. 作成する MastercardTAFHelper

Mastercard TAFのデバイスバインディング開始とトランザクション認証のためのヘルパーを作成します。

public void initMastercardTAFHelper(@NonNull TMGClientConfiguration tmgClientConfiguration) {
   byte[] password = this.getUserPassword();
       MastercardTAFHelper mastercardTAFHelper = TMGClient.getInstance().createMastercardTAFHelper(tmgClientConfiguration);
   } catch (TMGClientException e) {
       // エラーを処理します。
   }
}