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 通信サービスを有効にする

敏感なビューでsetFilterTouchesWhenObscured(true) CPSCommService を処理するために CPS メッセージ通信。

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

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

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

android:allowBackup="false">
    </application>

例 AndroidManifest.xml

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

<application

    <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" />

    android:allowBackup="false">
        </application>

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

        <!-- Your HCE service (example) -->
        <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>

    </manifest>
デフォルトでは、

HCE サービスの宣言は に記載されます HCE サービスを実装する