React Native Android端NFC/HCE手机卡片模拟实现问题求助

一、推荐可用的NFC库 #

针对你的需求（读取实体NFC卡片 + 手机模拟NFC卡片），优先推荐以下几个成熟的React Native库：

• react-native-nfc-manager：社区活跃度最高、功能最全面的NFC库，支持NFC标签读写、HCE（主机卡模拟），兼容Android和iOS，文档完善，问题排查资源多。
• react-native-hce：专注于Android HCE模拟功能的轻量库，适合仅需卡片模拟场景的开发者。
• expo-nfc：如果你基于Expo框架开发，官方提供的NFC模块，集成简单，支持基础读写和Android HCE模拟。

二、现有代码无响应的问题分析 #

你的代码存在以下几个关键问题：

1. 状态变量名错误：定义的状态更新函数是setIsTagRead，但回调里写成了setTagIsRead，导致状态无法更新。
2. 缺失权限与配置：Android需要在AndroidManifest.xml中添加NFC权限和HCE服务配置；iOS需要在Info.plist中配置NFC权限和AID过滤，否则NFC功能无法正常激活。
3. 无错误处理机制：未添加失败回调，无法定位启动模拟过程中出现的异常（比如设备不支持NFC、权限未授权等）。
4. 库的可靠性问题：react-native-nfc-sdk的社区维护性较差，API文档不完善，容易出现无响应情况。

三、修正后的代码示例（基于react-native-nfc-manager） #

1. 安装与配置 #

首先安装库：

npm install react-native-nfc-manager
# 或
yarn add react-native-nfc-manager

Android配置（AndroidManifest.xml）

添加权限和HCE服务：

<uses-permission android:name="android.permission.NFC" />
<uses-feature android:name="android.hardware.nfc" android:required="false" />

<!-- HCE服务配置 -->
<service android:name="com.reactnative.nfcmanager.HceService"
    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/apduservice" />
</service>

在res/xml目录下创建apduservice.xml：

<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:description="@string/servicedesc"
    android:requireDeviceUnlock="false">
    <aid-group android:description="@string/aiddescription"
        android:category="other">
        <aid-filter android:name="F0010203040506" />
    </aid-group>
</host-apdu-service>

iOS配置（Info.plist）

添加NFC权限和AID过滤：

<key>NFCReaderUsageDescription</key>
<string>需要访问NFC功能来读取和模拟卡片</string>
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
    <string>F0010203040506</string>
</array>

2. 功能实现代码 #

import React, { useEffect, useState } from 'react';
import { View, Text, Button, Alert } from 'react-native';
import NfcManager, { NfcTech, HCE_AID } from 'react-native-nfc-manager';

// 初始化NFC管理器
NfcManager.start();

export default function App() {
    const [isTagRead, setIsTagRead] = useState('No');
    const [isEmulating, setIsEmulating] = useState(false);

    // 检查设备NFC支持情况
    useEffect(() => {
        const checkNFCSupport = async () => {
            const supported = await NfcManager.isSupported();
            if (!supported) {
                Alert.alert('提示', '当前设备不支持NFC功能');
            }
        };
        checkNFCSupport();
        
        // 组件销毁时清理资源
        return () => {
            NfcManager.cancelTechnologyRequest();
            NfcManager.stopHCE();
        };
    }, []);

    // 读取实体NFC卡片
    const readNFC = async () => {
        try {
            await NfcManager.requestTechnology(NfcTech.Ndef);
            const tag = await NfcManager.getTag();
            
            if (tag.ndefMessage) {
                // 解析NDEF文本格式内容
                const payload = tag.ndefMessage[0].payload;
                const textContent = String.fromCharCode(...payload.slice(3));
                Alert.alert('读取成功', `卡片内容：${textContent}`);
            } else {
                Alert.alert('提示', '卡片不包含可读取的NDEF数据');
            }
        } catch (error) {
            Alert.alert('读取失败', error.message);
        } finally {
            NfcManager.cancelTechnologyRequest();
        }
    };

    // 启动NFC卡片模拟
    const startEmulation = async () => {
        try {
            // 注册HCE的AID（需与配置文件中的一致）
            await NfcManager.registerHCE([HCE_AID]);
            // 设置读卡器交互回调
            await NfcManager.setHCEMessageHandler((command) => {
                setIsTagRead('Yes!');
                setTimeout(() => setIsTagRead('No'), 5000);
                // 返回标准成功响应，可根据需求自定义
                return Promise.resolve(Buffer.from('9000', 'hex'));
            });
            setIsEmulating(true);
            Alert.alert('提示', '已启动NFC模拟');
        } catch (error) {
            Alert.alert('启动失败', error.message);
            setIsEmulating(false);
        }
    };

    // 停止NFC模拟
    const stopEmulation = async () => {
        try {
            await NfcManager.stopHCE();
            setIsEmulating(false);
            Alert.alert('提示', '已停止NFC模拟');
        } catch (error) {
            Alert.alert('停止失败', error.message);
        }
    };

    return (
        <View style={{ padding: 20, gap: 15, marginTop: 50 }}>
            <Button onPress={readNFC} title="读取实体NFC卡片" />
            <Button
                onPress={isEmulating ? stopEmulation : startEmulation}
                title={isEmulating ? '停止NFC模拟' : '启动NFC模拟'}
            />
            <Text style={{ marginTop: 20, fontSize: 16 }}>
                卡片是否被读取？{isTagRead}
            </Text>
        </View>
    );
}

内容的提问来源于stack exchange，提问作者niyoup74