Android默认启动器App首次NFC扫描触发系统Tag应用问题排查

配置信息 #

启动器Intent Filter #

<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
    <category android:name="android.intent.category.HOME" />
    <category android:name="android.intent.category.DEFAULT" />
</intent-filter>

NFC读取逻辑（BaseActivity.onResume） #

override fun onResume() {
    super.onResume()
    val manager: NfcManager = getSystemService(Context.NFC_SERVICE) as NfcManager
    nfcAdapter = manager.defaultAdapter
    if (nfcAdapter == null) {
        showMessage("NFC not supported on this device")
        return;
    }
    // Check if NFC is enabled
    if (nfcAdapter?.isEnabled == false) {
        showMessage("Enable NFC")
    }
    val options = Bundle()
    options.putInt(NfcAdapter.EXTRA_READER_PRESENCE_CHECK_DELAY, 200)

    nfcAdapter?.enableReaderMode(
        this,
        this,
        NfcAdapter.FLAG_READER_NFC_A or
        NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK ,
        options
    );
}

问题现象 #

设备重启后，应用作为默认启动器启动，首次扫描NFC标签时会弹出com.android.apps.tag的「New Tag Collected」界面；关闭该界面后再次扫描，应用的onTagReceived方法可正常触发。已确认onResume正常执行、NFC适配器启用正确，尝试过enableForegroundDispatch问题依旧，设备已root。

排查思路 #

• 系统NFC事件优先级：首次启动时，系统Tag应用可能因默认优先级更高，或应用前台状态未完全稳定，导致NFC事件被系统组件抢先捕获。
• 启动器初始化时机：设备重启后，应用作为默认启动器启动时，可能存在界面初始化延迟，enableReaderMode未及时生效，无法拦截首次NFC事件。
• 系统NFC组件监听：检查com.android.apps.tag是否在系统启动阶段就注册了高优先级的NFC广播接收器，抢占了事件处理权。

ADB解决方案（基于Root权限） #

1. 禁用系统Tag应用 #

直接禁用系统自带的Tag应用，避免其捕获NFC事件：

# 先确认Tag应用包名（部分设备包名可能不同）
adb shell pm list packages | grep tag
# 禁用应用
adb shell pm disable-user --user 0 com.android.apps.tag

2. 设置应用为NFC优先级处理包 #

通过系统设置指定你的应用为优先处理NFC事件的包：

adb shell settings put secure nfc_priority_package com.your.app.package

3. 调整NFC监听生效时机 #

在BaseActivity中增加窗口焦点监听，确保应用获得焦点后再启用NFC读取模式，避免启动阶段的状态不稳定：

override fun onWindowFocusChanged(hasFocus: Boolean) {
    super.onWindowFocusChanged(hasFocus)
    nfcAdapter?.takeIf { it.isEnabled && hasFocus }?.let { adapter ->
        val options = Bundle()
        options.putInt(NfcAdapter.EXTRA_READER_PRESENCE_CHECK_DELAY, 200)
        adapter.enableReaderMode(
            this,
            this,
            NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK,
            options
        )
    }
}

4. 强制应用为默认NFC处理（高风险） #

通过修改系统NFC配置文件（需Root权限），将你的应用加入优先列表，编辑/system/etc/permissions/android.hardware.nfc.xml，在<permissions>节点下添加：

<feature name="android.hardware.nfc">
    <priority>1000</priority>
    <package>com.your.app.package</package>
</feature>

注意：修改系统文件需谨慎，可能导致系统不稳定，操作前建议备份原文件。

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