@ylzj/react-native-nfc

• 读卡/写卡/扫描能力（来源：react-native-nfc-manager 的 vendored 源码）
• 模拟卡/HCE/APDU 能力（来源：react-native-host-card-emulation 的 vendored 源码）

安装

npm i --save @ylzj/react-native-nfc

使用

import {
  NfcManager,
  NfcTech,
  NativeHCEModule,
  createBackgroundHCE,
} from '@ylzj/react-native-nfc';

说明

• iOS 读卡能力依赖系统 CoreNFC（设备/系统限制以 Apple 为准）。
• iOS 的 HCE 需要 Apple entitlement；未配置时相关能力不可用。

Android：配置你自己的 AID（HCE）

本包在 Android 侧默认使用库内置的 @xml/aid_list 来声明可匹配的 AID 列表（用于锁端 SELECT AID）。

如果你在其他 React Native 项目里安装了本包，并希望使用你自己项目的 AID，推荐在你的 App 工程里覆盖同名资源文件：

• 路径：android/app/src/main/res/xml/aid_list.xml
• 效果：由于 Android 的资源合并优先级 App > library，你在 App 里放同名 aid_list.xml 会覆盖本包内置的默认 AID，无需修改 AndroidManifest.xml。

示例（把 F0010203040506 换成你们自己的 AID，十六进制字符串）：

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