萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android HCE (Host-based Card Emulation) 開發實戰:NFC 卡模擬與讀取完整流程

HCE 核心概念

  • Host-based Card Emulation:Android 4.4+ 引入,CPU 執行卡模擬邏輯,無需安全元件 (SE)。
  • 模擬 ISO 7816-4 智能卡(APDU 指令集),適用於支付、門禁、票務、身份識別。
  • 通過 AID (Application Identifier) 路由:讀卡器發送 SELECT AID,系統將對應 AID 的 APDU 轉發給注冊的 HCE 服務。

架構角色

角色組件職責
卡模擬端HostApduService 子類聲明支援的 AID,實現 processCommandApdu() 返回響應 APDU
讀卡端普通 App + NfcAdapter啟用前台調度,IsoDep.transceive() 發送 APDU 指令

CardEmulation 端實現 (模擬忠誠度卡)

1. 聲明 AID 元數據 (res/xml/aid_list.xml)

<aid-filter android:name="F222222222" android:description="Sample Loyalty Card" />

2. 服務聲明 (AndroidManifest.xml)

<service android:name=".MyHostApduService" android:exported="true"
    android:permission="android.permission.BIND_NFC_SERVICE">
    <intent-filter>
        <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
    </intent-filter>
    <meta-data android:name="android.nfc.cardemulation.host_apdu_service"
        android:resource="@xml/aid_list" />
</service>

3. 核心邏輯

public class MyHostApduService extends HostApduService {
    private static final String TAG = "HCE_Service";
    private static final byte[] SELECT_OK_SW = {(byte)0x90, (byte)0x00};
    private static final String ACCOUNT = "1234567890"; // 模擬賬號

    @Override
    public byte[] processCommandApdu(byte[] commandApdu, Bundle extras) {
        // 解析 SELECT APDU: CLA=00 INS=A4 P1=04 P2=00 Lc=xx Data=AID
        if (Arrays.equals(commandApdu, BuildSelectApdu("F222222222"))) {
            // 返回賬號 + 狀態字 9000
            byte[] payload = ACCOUNT.getBytes(StandardCharsets.UTF_8);
            byte[] response = new byte[payload.length + 2];
            System.arraycopy(payload, 0, response, 0, payload.length);
            response[response.length-2] = SELECT_OK_SW[0];
            response[response.length-1] = SELECT_OK_SW[1];
            return response;
        }
        return new byte[]{(byte)0x6A, (byte)0x82}; // File not found / 不支持指令
    }

    @Override public void onDeactivated(int reason) { /* 服務停用 */ }

    // 工具方法:構建 SELECT APDU
    public static byte[] BuildSelectApdu(String aid) {
        // CLA=00 INS=A4 P1=04 P2=00 Lc=aid.length/2 Data=aid
        return HexStringToByteArray("00A40400" + String.format("%02X", aid.length()/2) + aid);
    }
    // HexStringToByteArray 實現略
}

CardReader 端實現 (讀取模擬卡)

public final class CardReader {
    private static final String SAMPLE_AID = "F222222222";
    private static final String SELECT_APDU_HEADER = "00A40400";
    private static final byte[] SELECT_OK_SW = {(byte)0x90, (byte)0x00};

    public static String readCard(Tag tag) {
        IsoDep isoDep = IsoDep.get(tag);
        if (isoDep == null) return null;
        try {
            isoDep.connect();
            byte[] selectApdu = BuildSelectApdu(SAMPLE_AID);
            byte[] result = isoDep.transceive(selectApdu);
            int len = result.length;
            byte[] sw = {result[len-2], result[len-1]};
            if (Arrays.equals(SELECT_OK_SW, sw)) {
                String account = new String(Arrays.copyOf(result, len-2), "UTF-8");
                return account; // "1234567890"
            }
        } catch (IOException e) { Log.e(TAG, "Communication error", e); }
        return null;
    }
    // BuildSelectApdu 同服務端
}

啟用前台調度 (Reader 模式)

// Activity.onResume()
NfcAdapter nfc = NfcAdapter.getDefaultAdapter(this);
PendingIntent pending = PendingIntent.getActivity(this, 0, new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), 0);
IntentFilter[] filters = new IntentFilter[] { new IntentFilter(NfcAdapter.ACTION_TECH_DISCOVERED) };
String[][] techLists = new String[][] { { IsoDep.class.getName() } };
nfc.enableForegroundDispatch(this, pending, filters, techLists);

// Activity.onPause()
nfc.disableForegroundDispatch(this);

測試驗證

  1. 手機 A 運行 CardEmulation App(需設為預設 NFC 支付/模擬卡應用:設置→NFC→非接觸式支付)。
  2. 手機 B 運行 CardReader App。
  3. 雙手機背靠背靠近 → Reader 顯示讀取到的賬號。

注意事項與最佳實踐

  • AID 唯一性:生產環境需向 EMVCo/相關機構註冊專屬 AID(前 5 字節 RID 標識發行機構)。
  • APDU 協議:嚴格遵循 ISO 7816-4,支持鏈式傳輸、安全消息、PIN 驗證等高級特性。
  • 安全性:敏感密鑰存儲於 Android Keystore (TEE/StrongBox),HCE 服務僅作業務邏輯處理。
  • 兼容性:Android 4.4+,需 NFC 控制器支持 HCE(絕大多數現代設備支持)。
  • 低版本回退:Android 4.3- 需 SE 安全元件 (UICC/eSE),走 CardEmulation 不同路徑。
copyright © 萬盛學電腦網 all rights reserved