BIG BUG v4.1.1 nfc tag not working.

[onderadaidenfit]

nfc tag no data. The new version no longer includes data.

v3.5.0 working code.

import 'dart:async';
import 'dart:io';

import 'package:easy_localization/easy_localization.dart';
import 'package:nfc_manager/nfc_manager.dart';
import 'package:people/common/data/model/response/data_response.dart';
import 'package:people/init/lang/locale_keys.g.dart';

///Use all nfc methods.
final class NfcUtil {
///Singleton Lazy
factory NfcUtil() {
_instance ??= NfcUtil._internal();
return _instance!;
}

NfcUtil._internal();

static NfcUtil? _instance;

final _mifareUltraLight = 'mifareultralight';
final _mifare = 'mifare';
final _identifier = 'identifier';
var _isRunning = false;

///Start
Future<DataResponse> start() async {
final completer = Completer<DataResponse>();

// Check availability
final isAvailable = await NfcManager.instance.isAvailable();

if (isAvailable) {
  _isRunning = true;
  await NfcManager.instance.startSession(
    pollingOptions: {NfcPollingOption.iso14443},
    onDiscovered: (NfcTag tag) async {
      // Do something with an NfcTag instance.
      //debugPrint('data: ${tag.data}');
      if (!_isRunning) {
        return;
      }

      final mifare = (tag.data[_mifareUltraLight] ?? tag.data[_mifare]) as Map<Object?, Object?>?;
      if (mifare != null) {
        final identifier = mifare[_identifier] as List<int>?;
        if (identifier != null) {
          final currentTag = identifier.map((e) => e.toRadixString(16).padLeft(2, '0')).join();
          //debugPrint('currentTag Code: $currentTag');
          completer.complete(DataResponse(data: currentTag));
        } else {
          completer.complete(DataResponse(error: LocaleKeys.no_data.tr()));
        }
      } else {
        completer.complete(DataResponse(error: LocaleKeys.no_data.tr()));
      }

      _isRunning = false;
      if (Platform.isAndroid) {
        await Future<void>.delayed(const Duration(seconds: 2)).then((
          value,
        ) async {
          await NfcManager.instance.stopSession();
        });
      } else {
        await NfcManager.instance.stopSession();
      }
    },
    onError: (error) async {
      completer.complete(DataResponse(error: error.message));
      return;
    },
  );
} else {
  completer.complete(DataResponse(error: LocaleKeys.nfc_is_available.tr()));
}

return completer.future;

}
}

[onderadaidenfit]

@okadan ?

[Weian-wang]

ISO7816 NFC 标签读取问题 - 详细修复说明

📋 问题描述

在使用 nfc_manager 插件读取 ISO7816 NFC 标签时，遇到了以下问题：

1. 症状：

   • 标签能被系统检测到（控制台会显示错误信息）
   • 但是 onDiscovered 回调不会被触发
   • 控制台会出现以下错误之一：
     • Error Domain=NFCError Code=403 "NDEF tag does not contain any NDEF message"
     • Error Domain=NFCError Code=104 "Stack Error"

2. 根本原因：

   • 插件在处理 ISO7816 标签时，会先查询 NDEF 状态
   • ISO7816 标签不支持 NDEF 格式，导致 NDEF 查询失败
   • 插件在 NDEF 查询失败时，直接返回 nil 并终止转换
   • 虽然 ISO7816 标签数据已经在第 737-744 行被正确填充到 pigeon.iso7816
   • 但因为 NDEF 查询失败，整个转换被中断，onDiscovered 回调永远不会被调用

🔍 技术细节

问题代码位置

文件：~/.pub-cache/hosted/pub.dev/nfc_manager-4.1.1/ios/Classes/NfcManagerPlugin.swift

问题代码（第 754-757 行）：

value.queryNDEFStatus { status, capacity, error in
  if let error = error {
    completionHandler(nil, error)  // ❌ 直接返回 nil，导致转换失败
    return
  }
  // ...
}

流程分析：

1. ✅ 标签被系统检测到（didDetect 被调用）
2. ✅ ISO7816 标签数据被正确填充（第 737-744 行）

   else if let value = value as? NFCISO7816Tag {
     pigeon.iso7816 = Iso7816Pigeon(...)  // ✅ 数据已填充
   }

3. ❌ 插件尝试查询 NDEF 状态（第 754 行）
4. ❌ NDEF 查询失败（ISO7816 不支持 NDEF）
5. ❌ 插件调用 completionHandler(nil, error)（第 756 行）
6. ❌ didDetect 中的转换失败（第 657 行）
7. ❌ 插件只打印错误并重启轮询，不调用 Flutter 回调
8. ❌ onDiscovered 永远不会被触发

🛠️ 修复方法

临时修复（当前已应用）

修改插件源代码，在 NDEF 查询失败时检查是否已有标签数据：

修复位置 1（第 754-765 行）：

value.queryNDEFStatus { status, capacity, error in
  if let error = error {
    // Fix: 如果已经有标签数据（如 ISO7816、MiFare、FeliCa、ISO15693），即使 NDEF 失败也返回数据
    if pigeon.iso7816 != nil || pigeon.miFare != nil || pigeon.feliCa != nil || pigeon.iso15693 != nil {
      // 设置 NDEF 为不支持，但仍然返回标签数据
      pigeon.ndef = NdefPigeon(status: NdefStatusPigeon.notSupported, capacity: 0)
      completionHandler(pigeon, nil)  // ✅ 返回标签数据而不是 nil
      return
    }
    // 如果没有其他标签数据，才返回错误
    completionHandler(nil, error)
    return
  }
  // ... 正常流程
}

修复位置 2（第 775-784 行，NDEF 读取错误处理）：

value.readNDEF { message, error in
  if let error = error {
    // Fix: 如果已经有标签数据，即使 NDEF 读取失败也返回数据
    if pigeon.iso7816 != nil || pigeon.miFare != nil || pigeon.feliCa != nil || pigeon.iso15693 != nil {
      completionHandler(pigeon, nil)  // ✅ 返回标签数据
      return
    }
    // 如果没有其他标签数据，才返回错误
    completionHandler(nil, error)
    return
  }
  // ... 正常流程
}

修复效果

• ✅ NDEF 查询失败时，如果已有 ISO7816 数据，会返回这些数据
• ✅ onDiscovered 回调现在可以被正常触发
• ✅ 可以成功读取 ISO7816 标签信息

⚠️ 重要提醒

当前修复的局限性：

1. 修改的是 ~/.pub-cache/ 中的文件，这是插件的缓存位置
2. 当你运行以下命令时，修复会被覆盖：
   • flutter pub get
   • flutter pub upgrade
   • flutter clean（如果后续重新获取依赖）
   • 删除并重新安装插件

🔧 长期解决方案

方案 1：Fork 插件并维护自己的版本（推荐）

步骤 1：Fork 插件仓库

1. 访问 https://github.com/okadan/nfc_manager
2. 点击 "Fork" 按钮，创建你的 fork

步骤 2：应用修复

1. 克隆你的 fork：

   git clone https://github.com/你的用户名/nfc_manager.git
   cd nfc_manager

2. 修改文件：ios/Classes/NfcManagerPlugin.swift

   • 应用上面提到的修复代码
   • 提交更改：

     git add ios/Classes/NfcManagerPlugin.swift
     git commit -m "Fix: Return tag data when NDEF query fails for ISO7816 tags"
     git push origin main

步骤 3：在项目中使用你的 fork

修改 pubspec.yaml：

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.8
  nfc_manager:
    git:
      url: https://github.com/你的用户名/nfc_manager.git
      ref: main  # 或你的分支名

然后运行：

flutter pub get

方案 2：向插件作者提交 Issue 和 PR

提交 Issue

1. 访问 https://github.com/okadan/nfc_manager/issues
2. 创建新 Issue，包含：
   • 问题描述
   • 重现步骤
   • 错误日志
   • 修复建议

提交 Pull Request

1. Fork 仓库并应用修复
2. 创建 Pull Request，描述：
   • 问题：ISO7816 标签在 NDEF 查询失败时无法被读取
   • 修复：在 NDEF 查询失败时检查是否已有标签数据，如果有则返回数据而不是错误
   • 测试：已测试 ISO7816 标签读取成功

方案 3：保留修复脚本（临时方案）

如果你暂时不想 fork，可以创建一个脚本来自动应用修复：

创建文件 scripts/fix_nfc_plugin.sh：

#!/bin/bash

PLUGIN_PATH="$HOME/.pub-cache/hosted/pub.dev/nfc_manager-4.1.1/ios/Classes/NfcManagerPlugin.swift"

echo "Applying NFC plugin fix..."

# 备份原始文件
cp "$PLUGIN_PATH" "$PLUGIN_PATH.backup"

# 应用修复（使用 sed 或其他工具）
# 注意：这里需要根据实际情况调整 sed 命令

echo "Fix applied. Please rebuild the project."

然后在每次 flutter pub get 后运行这个脚本。

📝 项目配置总结

以下是当前项目中的正确配置（供参考）：

1. pubspec.yaml

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.8
  nfc_manager: ^4.1.1

2. ios/Podfile

platform :ios, '13.0'
# ... 其他配置

3. ios/Runner/Info.plist

<key>NFCReaderUsageDescription</key>
<string>此应用需要使用 NFC 功能来读取 ISO7816 标签</string>
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
    <string>D2760000850101</string>
</array>

4. ios/Runner/Runner.entitlements

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.developer.nfc.readersession.formats</key>
    <array>
        <string>TAG</string>
    </array>
</dict>
</plist>

5. ios/Runner.xcodeproj/project.pbxproj

确保 Debug 配置中：

ENABLE_TESTABILITY = NO;  // 避免 dyld 错误

6. lib/main.dart 代码要点

import 'package:nfc_manager/nfc_manager.dart';
import 'package:nfc_manager/nfc_manager_ios.dart';  // 必需

// 使用 Iso14443 polling（ISO7816 使用此标准）
await NfcManager.instance.startSession(
  pollingOptions: {
    NfcPollingOption.iso14443,
  },
  onDiscovered: (NfcTag tag) async {
    // 使用 Iso7816Ios.from() 读取标签
    final iso7816Tag = Iso7816Ios.from(tag);
    if (iso7816Tag != null) {
      // 成功读取 ISO7816 标签数据
      // ...
    }
  },
);

✅ 验证修复

修复成功后，你应该看到：

1. 控制台日志：

   🔍🔍🔍 [onDiscovered] 检测到 NFC 标签！🔍🔍🔍
   ✅ 成功识别为 ISO7816 标签
   

2. 应用界面：

   • 显示 ISO7816 标签的详细信息
   • 包括：AID、标识符、历史字节、应用数据等

📚 相关资源

• nfc_manager 插件：https://pub.dev/packages/nfc_manager
• 插件 GitHub：https://github.com/okadan/nfc_manager
• iOS NFC 文档：https://developer.apple.com/documentation/corenfc
• ISO7816 标准：https://en.wikipedia.org/wiki/ISO/IEC_7816

🎯 总结

1. 问题根源：插件在 NDEF 查询失败时直接返回 nil，忽略了已填充的 ISO7816 数据
2. 临时修复：修改插件代码，在 NDEF 失败时检查并返回已有标签数据
3. 长期方案：Fork 插件或提交 PR，确保修复不被覆盖
4. 当前状态：✅ 修复已生效，ISO7816 标签可以正常读取

---

最后更新：2025年
修复版本：nfc_manager 4.1.1

[philitell]

Any updates on this?

[taogeshuai]

Version 3.4.0 is the last version that supports iOS NDEF. Versions after 3.4.0 do not support it.

[onderadaidenfit]

https://pub.dev/packages/nfc_util