3. アプリケーションマニフェストファイル

設定する AndroidManifest.xml NFC Wallet SDK が正しく動作できるようにします。

Android の権限

次の権限を宣言します AndroidManifest.xml:

Android の権限	要件	説明
android.permission.INTERNET	必須	ネットワーク呼び出しを有効にします（たとえば、登録や決済キーの再補充）。
android.permission.NFC	必須	非接触決済のための NFC アクセスを有効にします。
android.permission.USE_BIOMETRIC	条件付き	CDCVM として生体認証を有効にします。
android.permission.USE_FINGERPRINT	条件付き	生体認証を CDCVM として使用する場合は、Android 9 以前をサポートします。

NFC 機能を宣言する

非接触決済では、デバイスは次をサポートしている必要があります:

• android.hardware.nfc
• android.hardware.nfc.hce

オプション A: Google Play で非対応デバイスを除外する

両方の機能を必須として宣言します:

<uses-feature android:name="android.hardware.nfc" android:required="true" />
<uses-feature android:name="android.hardware.nfc.hce" android:required="true" />

uses-feature これらの宣言により、Google Play でアプリは互換性のあるデバイスのみにフィルタされます。

オプション B: インストールを許可し、実行時に確認する

Google Play でデバイスの互換性を絞り込めない場合は、Android API を使用して機能のサポートを確認します:

public static boolean doesDeviceSupportHCE(@NonNull final Context context) {
    final PackageManager pm = context.getPackageManager();
    final boolean hasNfc = pm.hasSystemFeature(PackageManager.FEATURE_NFC);
    final boolean supportsHce = pm.hasSystemFeature(PackageManager.FEATURE_NFC_HOST_CARD_EMULATION);
    
    if (!hasNfc || !supportsHce) {
        // このデバイスは NFC または HCE をサポートしていません。
        return false;    
    }
    return true;
}

CPS 通信サービスを有効にする

有効にする CPSCommService 処理する CPS メッセージ通信。

<!-- CPS 通信サービス -->
<service
    android:name="com.gemalto.mfs.mwsdk.provisioning.push.CPSCommService"
    android:enabled="true"
    android:exported="false" />

バックアップと復元を無効にする

Android アプリのバックアップと復元を無効にします。

<application
    android:allowBackup="false">

例 AndroidManifest.xml

この例では、必要となる一般的な宣言を示します。名前とメタデータをデジタルウォレットアプリに合わせて調整してください。

<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.NFC" />
    <uses-permission android:name="android.permission.USE_BIOMETRIC" />
    <uses-permission android:name="android.permission.USE_FINGERPRINT" />

    <uses-feature android:name="android.hardware.nfc" android:required="true" />
    <uses-feature android:name="android.hardware.nfc.hce" android:required="true" />

    <application
        android:allowBackup="false">

        <service
            android:name="com.gemalto.mfs.mwsdk.provisioning.push.CPSCommService"
            android:enabled="true"
            android:exported="false" />

        <!-- あなたの HCE サービス（例） -->
        <service
            android:name=".payment.contactless.YourHostApduService"
            android:exported="true"
            android:permission="android.permission.BIND_NFC_SERVICE">
            <intent-filter>
                <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>

            <meta-data
                android:name="android.nfc.cardemulation.host_apdu_service"
                android:resource="@xml/apduservice" />
        </service>

    </application>
</manifest>

HCE サービスの宣言については、次で説明します HCE サービスの実装