引入flutter_nfc_kit包后Flutter项目编译失败求助

问题概述 #

在Flutter项目的pubspec.yaml中添加flutter_nfc_kit: ^3.3.3依赖后，只要在Dart文件中引入该包（import 'package:flutter_nfc_kit/flutter_nfc_kit.dart';），项目编译就会失败，核心错误为：Uint8List类不存在toHexString方法、String类不存在toBytes方法，具体报错信息如下：

../../../AppData/Local/Pub/Cache/hosted/pub.dev/flutter_nfc_kit-3.3.3/lib/flutter_nfc_kit.dart:146:30: Error: The method 'toHexString' isn't defined for the class 'Uint8List'.
 - 'Uint8List' is from 'dart:typed_data'.
Try correcting the name to the name of an existing method, or defining a method named 'toHexString'.
    return NDEFRawRecord(id?.toHexString() ?? '', payload?.toHexString() ?? '',
                             ^^^^^^^^^^^
../../../AppData/Local/Pub/Cache/hosted/pub.dev/flutter_nfc_kit-3.3.3/lib/flutter_nfc_kit.dart:154:38: Error: The method 'toBytes' isn't defined for the class 'String'.
Try correcting the name to the name of an existing method, or defining a method named 'toBytes'.
        raw.typeNameFormat, raw.type.toBytes(), raw.payload.toBytes(),
                                     ^^^^^^^
# 其余类似错误省略
Target kernel_snapshot failed: Exception

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:compileFlutterBuildDebug'.
> Process 'command 'C:\Users\Public\Programs\flutter\bin\flutter.bat'' finished with non-zero exit value 1

解决方法 #

1. 补全缺失的依赖包 #

flutter_nfc_kit依赖hex包提供toHexString和toBytes扩展方法，可能是pub拉取依赖时未自动获取该包。执行以下操作：

• 先清理缓存并检查依赖：

  flutter clean
  flutter pub deps --no-dev | grep hex
  

• 如果输出中没有hex包，手动在pubspec.yaml中添加：

  dependencies:
    hex: ^0.2.0  # 可替换为兼容的最新版本
  

• 重新拉取依赖：

  flutter pub get
  

2. 降级flutter_nfc_kit版本 #

3.3.3版本可能存在依赖配置疏漏，尝试降级到稳定版本（如3.3.2）：

• 修改pubspec.yaml中的依赖：

  dependencies:
    flutter_nfc_kit: ^3.3.2
  

• 清理缓存并重新构建：

  flutter clean && flutter pub get
  

3. 手动修复包内代码（临时应急方案） #

如果上述方法无效，可直接修改缓存中的flutter_nfc_kit源码：

1. 打开报错文件：../../../AppData/Local/Pub/Cache/hosted/pub.dev/flutter_nfc_kit-3.3.3/lib/flutter_nfc_kit.dart
2. 在文件顶部添加hex包导入：

   import 'package:hex/hex.dart';
   

3. 替换所有缺失的方法调用：
   • id?.toHexString() ?? '' → id != null ? HEX.encode(id!) : ''
   • payload?.toHexString() ?? '' → payload != null ? HEX.encode(payload!) : ''
   • type?.toHexString() ?? '' → type != null ? HEX.encode(type!) : ''
   • raw.type.toBytes() → HEX.decode(raw.type)
   • raw.payload.toBytes() → HEX.decode(raw.payload)
   • raw.identifier.toBytes() → HEX.decode(raw.identifier)

注意：该方法在重新拉取依赖后会失效，仅作为临时解决手段。

补充说明 #

本次报错来自Dart层的扩展方法缺失，与Kotlin版本差异无关，无需调整项目的Kotlin或Gradle版本。

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