Android端禁用「已收集新标签」NFC提示消息的方案咨询

核心原因 #

系统弹出该提示，是因为当前应用未优先拦截到NFC标签事件：当标签不匹配应用声明的Intent过滤规则，或应用未启用前台NFC调度机制时，系统会接管事件并显示默认提示。

具体解决方案 #

1. 完善AndroidManifest.xml的NFC过滤规则 #

当前仅声明了NDEF_DISCOVERED，只能匹配特定MIME类型的NDEF标签，非NDEF格式或其他类型的标签会触发系统提示。需补充通用过滤规则：

步骤1：创建NFC技术过滤资源文件

在res/xml目录下新建nfc_tech_filter.xml（无xml目录则手动创建），内容如下：

<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
    <tech-list>
        <tech>android.nfc.tech.IsoDep</tech>
        <tech>android.nfc.tech.NfcA</tech>
        <tech>android.nfc.tech.NfcB</tech>
        <tech>android.nfc.tech.NfcF</tech>
        <tech>android.nfc.tech.NfcV</tech>
        <tech>android.nfc.tech.Ndef</tech>
        <tech>android.nfc.tech.NdefFormatable</tech>
        <tech>android.nfc.tech.MifareClassic</tech>
        <tech>android.nfc.tech.MifareUltralight</tech>
    </tech-list>
</resources>

步骤2：更新Manifest中的Activity配置

补充TECH_DISCOVERED和TAG_DISCOVERED的Intent过滤：

<activity
    android:name=".MainActivity"
    android:label="@string/app_name"
    android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
    android:launchMode="singleTask"
    android:windowSoftInputMode="adjustResize"
    android:exported="true">
    <!-- 原有启动页过滤保留 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <!-- 原有NDEF格式标签过滤保留 -->
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="application/vnd.hello.sample.nfcmanager" />
    </intent-filter>
    <!-- 新增通用标签过滤 -->
    <intent-filter>
        <action android:name="android.nfc.action.TAG_DISCOVERED"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
    <!-- 关联NFC技术过滤资源 -->
    <meta-data
        android:name="android.nfc.action.TECH_DISCOVERED"
        android:resource="@xml/nfc_tech_filter" />
</activity>

2. 启用前台NFC调度机制 #

通过前台调度，让应用在前台时优先捕获NFC事件，阻止系统弹出提示。修改React Native代码如下：

import NfcManager, {NfcTech} from 'react-native-nfc-manager';
import {Platform, ToastAndroid} from 'react-native';
import {useEffect} from 'react';

// 在需要读取NFC的组件中注册前台监听
useEffect(() => {
  let tagListener;

  const initNFC = async () => {
    await NfcManager.start();
    // 注册前台标签监听，优先拦截事件
    tagListener = NfcManager.registerTagEvent(tag => {
      if (tag.id) {
        // 自定义标签处理逻辑，比如获取ID
        console.log('检测到标签ID:', tag.id);
        // 可替换为自定义提示，替代系统默认提示
        if (Platform.OS === 'android') {
          ToastAndroid.show('已检测到NFC标签', ToastAndroid.SHORT);
        } else {
          NfcManager.setAlertMessageIOS('TAG detect');
        }
      }
      // 释放NFC资源
      NfcManager.unregisterTagEvent(tagListener);
    });
  };

  initNFC();

  // 组件卸载时清理监听
  return () => {
    if (tagListener) {
      NfcManager.unregisterTagEvent(tagListener);
    }
    NfcManager.stop();
  };
}, []);

// 若需单次读取函数，调整为支持多技术类型
const readNFC = async (): Promise<string | undefined> => {
  return new Promise(async (resolve, reject) => {
    try {
      // 请求多种NFC技术，兼容更多标签类型
      await NfcManager.requestTechnology([NfcTech.Ndef, NfcTech.NdefFormatable, NfcTech.MifareClassic]);
      const tag = await NfcManager.getTag();
      if (Platform.OS === 'ios') {
        await NfcManager.setAlertMessageIOS('TAG detect');
      }
      await NfcManager.cancelTechnologyRequest();
      resolve(tag?.id);
    } catch (er) {
      reject('读取NFC标签失败');
    }
  });
};

3. 关键注意事项 #

• 仅当应用处于前台时，前台调度才能阻止系统提示（后台状态下系统提示是Android默认行为，无法完全禁用）。
• 若标签为Mifare等特殊类型，需在requestTechnology中添加对应技术类型（如NfcTech.MifareClassic）。
• Android 10及以上无需动态申请NFC权限，低版本可通过react-native-nfc-manager自动处理权限请求。

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