HarmonyOS鸿蒙Next中使用nfc卡片想拉起我们的应用，在4.0系统上可以唤起，但是在5.0、6.0上不能唤起，这个可能是什么原因导致的呢

HarmonyOS鸿蒙Next中使用nfc卡片想拉起我们的应用，在4.0系统上可以唤起，但是在5.0、6.0上不能唤起，这个可能是什么原因导致的呢 【问题描述】：我使用nfc卡片想拉起我们的应用， 在4.0系统上可以唤起， 但是在5.0、6.0上不能唤起 这个可能是什么原因导致的呢

【问题现象】：尝试了下在nfc卡片里写入微信的包名及数据，在4.0，5.0，6.0版本里都是可以正常拉起的，但拉起我们的应用只能在4.0版本中正常拉起，5.0和6.0都拉起失败，可能是什么原因导致的呢

【版本信息】：DevEco Studio 6.0.0.868，手机版本：HarmonyOS 6.0.0，API版本：20

【复现代码】：未涉及

【尝试解决方案】：未涉及


更多关于HarmonyOS鸿蒙Next中使用nfc卡片想拉起我们的应用，在4.0系统上可以唤起，但是在5.0、6.0上不能唤起，这个可能是什么原因导致的呢的实战教程也可以访问 https://www.itying.com/category-93-b0.html

5 回复

开发者你好，

请问使用的是什么方式拉起失败，是deeplink，AppLink还是startAbility，请再提供报错信息。

更多关于HarmonyOS鸿蒙Next中使用nfc卡片想拉起我们的应用，在4.0系统上可以唤起，但是在5.0、6.0上不能唤起，这个可能是什么原因导致的呢的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


4.0是非纯血鸿蒙，5.0+之后的都是纯血鸿蒙。建议检查下你的配置文件“module.json5”，检查下5.0+之后是不是要额外加其他字段项。

  1. 你们鸿蒙上hap的包名和鸿蒙4.x也就是apk包名一致吗？
  2. 然后 module.json5 里面配置skills了没。
    1. 声明"actions"字段的内容填写，必须包含"ohos.nfc.tag.action.TAG_FOUND"，不能更改。
    2. 声明技术时"uris"中"type"字段的内容填写，前缀必须是"tag-tech/"，后面接着NfcA/NfcB/NfcF/NfcV/IsoDep/Ndef/MifareClassic/MifareUL/NdefFormatable"中的一个。如果存在多个"type"时，需要分行填写。填写错误会造成解析失败。
    3. 声明权限时"requestPermissions"中的"name"字段的内容填写，必须是"ohos.permission.NFC_TAG"，不能更改。

参考：

鸿蒙Next中NFC拉起应用失败可能因权限配置差异。5.0/6.0系统对NFC权限管控更严格，需检查应用是否在config.json中正确声明NFC权限，并确保过滤条件与卡片类型匹配。同时确认应用已安装并启用NFC相关能力。

根据你的描述，问题很可能出在HarmonyOS 5.0和6.0版本对应用拉起机制的安全策略升级上。从4.0到6.0，系统在应用间跳转和隐式启动（如通过NFC触发）方面引入了更严格的管控。

最可能的原因是：你的应用在5.0及以上版本中，缺少必要的权限声明或配置，导致系统阻止了此次隐式启动。

请重点排查以下几个方面：

  1. 应用可见性（Ability Visibility）与跨设备启动权限：

    • 在API 9（对应HarmonyOS 5.0的基线）及以后版本，系统对Ability的跨应用/跨设备拉起有更严格的要求。确保被NFC拉起的Ability在module.json5配置文件中，其abilities标签下正确声明了"visible": true。这是允许其他应用或系统组件发现并启动它的前提。
    • 同时，检查是否需要在module.json5的requestPermissions中申请ohos.permission.START_ABILITIES_FROM_BACKGROUND权限，该权限用于允许应用从后台启动其他应用。

  2. NFC标签的Intent过滤配置：

    • 确认你的应用对NFC标签的响应配置正确。在目标Ability的skills过滤器（filter）中，entities字段应包含"entity.system.nfc"，并且actions字段应包含"ohos.want.action.nfc.tag"。确保其与NFC卡片中写入的AID（应用标识符）或NDEF数据格式完全匹配。

  3. 应用启动模式（LaunchType）：

    • 检查被拉起的Ability的launchType配置。如果设置为singleton（单实例），且该Ability已在后台运行，系统可能不会创建新实例，而是尝试切换到现有实例。这有时会导致拉起行为与预期不符。可以尝试调整为standard模式进行测试。

  4. 系统版本差异化的API行为：

    • HarmonyOS 5.0（API 9）是一个重要的架构升级版本。从该版本开始，系统默认行为可能发生了变化。例如，对于通过NFC等隐式Want启动的应用，系统可能会更严格地检查应用是否在前台有可见活动，或者是否具有相应的后台启动权限。

建议的排查步骤：

  1. 首先，详细核对并更新你的module.json5配置文件，确保上述的可见性、权限和Intent过滤器配置无误，并符合API 20（HarmonyOS 6.0）的规范。
  2. 在DevEco Studio中，使用针对API 20的模拟器或真机进行调试，查看Logcat日志。在尝试用NFC卡片拉起应用时，系统通常会输出详细的日志信息，其中会包含启动失败的原因（例如权限拒绝、未找到匹配的Ability等），这是定位问题最直接的途径。
  3. 参考华为官方文档中关于【NFC标签开发】和【应用启动规则】在API 9及以上版本的变更说明，确认你的实现方式是否已适配最新规范。

由于你提到写入微信包名可以正常拉起，这基本排除了NFC卡片本身和系统基础NFC功能的问题，焦点应集中在你的应用配置是否符合高版本系统的安全启动策略。请优先从应用配置和系统日志入手排查。

回到顶部