修改Android应用包名后NFC功能失效问题求助

问题概述 #

开发的NFC标签扫描应用原本可正常扫描、读写标签，修改应用包名后NFC功能完全失效，恢复原包名后功能又恢复正常。

核心原因分析 #

• NFC过滤规则的包名绑定：Android系统中，TECH_DISCOVERED对应的XML过滤文件如果硬编码了原包名，修改包名后系统无法匹配，导致标签扫描的Intent无法传递到应用。
• Activity导出属性限制：配置了NFC Intent Filter的Activity若设置android:exported="false"，系统无法向其发送外部NFC触发的Intent。
• 系统NFC配置缓存：系统会缓存应用的NFC相关配置，修改包名后旧缓存未清除，导致系统仍向原包名应用发送NFC Intent。

具体排查方向 #

• 检查nfc_tech_filter.xml文件
  打开res/xml/nfc_tech_filter.xml，确认没有硬编码原包名，正确格式应仅声明支持的NFC技术类型，示例：

  <resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
      <tech-list>
          <tech>android.nfc.tech.Ndef</tech>
          <tech>android.nfc.tech.NdefFormatable</tech>
      </tech-list>
  </resources>
  

  若存在原包名相关的硬编码，替换为通用技术类型。

• 修正Activity导出属性
  配置了NFC Intent Filter的HomeActivity需将android:exported设为true，否则系统无法向其发送NFC触发的Intent：

  <activity
      android:name=".ui.HomeActivity"
      android:exported="true">
      <!-- 原Intent Filter和Meta-data保持不变 -->
  </activity>
  

• 清除系统缓存并重装应用

  • 卸载旧版本应用，进入手机设置-应用-系统NFC应用，清除其缓存；
  • 重启手机后，安装修改包名后的新版本应用，确保系统重新加载NFC配置。

• 验证Foreground Dispatch有效性
  在ActivateActivity的onNewIntent方法中添加日志，确认是否能接收NFC Intent：

  override fun onNewIntent(intent: Intent) {
      super.onNewIntent(intent)
      Log.d("NFC", "收到Intent Action: ${intent.action}")
      setIntent(intent)
      readFromIntent(intent)
      if (NfcAdapter.ACTION_TAG_DISCOVERED == intent.action) {
          myTag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
      }
  }
  

  若未收到日志，检查enableForegroundDispatch调用是否异常，或Intent的组件包名是否为修改后的新包名。

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