Flutter安卓应用使用zebra_scanner_plugin初始化扫描器崩溃求助

问题描述 #

我在安卓Flutter应用中使用zebra_scanner_plugin进行RFID扫描，已完成官方配置指南要求的所有步骤。调用以下初始化连接方法：

Future<void> initAndConnectScanner() async {
  try {
    await ZebraScannerPlugin.initScanner;
    await ZebraScannerPlugin.connect();
  } catch (e) {
    print("Error initializing or connecting: $e");
  }
}

点击按钮触发该方法后，应用直接崩溃，抛出如下错误日志：

Failed to handle method call
E/MethodChannel#zebra_scanner_plugin(18987): java.lang.NullPointerException: Attempt to invoke virtual method 'com.zebra.scannercontrol.DCSSDKDefs$DCSSDK_RESULT com.zebra.scannercontrol.SDKHandler.dcssdkSetDelegate(com.zebra.scannercontrol.IDcsSdkApiDelegate)' on a null object reference
E/MethodChannel#zebra_scanner_plugin(18987):    at com.androsys.zebra_scanner_plugin.ZebraScannerEngine.initialize(ZebraScannerEngine.java:52)
E/MethodChannel#zebra_scanner_plugin(18987):    at com.androsys.zebra_scanner_plugin.ZebraScannerEngine.<init>(ZebraScannerEngine.java:31)
E/MethodChannel#zebra_scanner_plugin(18987):    at com.androsys.zebra_scanner_plugin.ZebraScannerEngine.getInstance(ZebraScannerEngine.java:37)

请问我是否操作有误？是否需要编写Java代码？

问题分析与解决 #

这个空指针错误的核心原因是插件底层的SDKHandler实例未完成初始化，就调用了dcssdkSetDelegate方法，大概率是配置遗漏或初始化顺序问题，不需要额外编写Java代码，按以下步骤排查：

• 检查安卓端配置完整性

  • 确认AndroidManifest.xml中添加了RFID/蓝牙扫描所需权限：

    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    

  • 验证build.gradle（Module级别）中是否正确引入Zebra SDK依赖，插件通常会自动处理，但离线环境可能需要手动添加：

    implementation 'com.zebra:scannercontrol:2.14.289'
    

• 调整初始化顺序
  不要连续同步调用initScanner和connect，确保初始化完成且成功后再执行连接操作，可修改代码为：

  Future<void> initAndConnectScanner() async {
    try {
      // 先完成初始化
      await ZebraScannerPlugin.initScanner;
      // 添加短暂延迟，确保底层实例初始化完成
      await Future.delayed(const Duration(milliseconds: 500));
      // 再执行连接
      await ZebraScannerPlugin.connect();
    } catch (e) {
      print("Error initializing or connecting: $e");
    }
  }
  

• 提前注册扫描回调
  部分插件要求先注册扫描结果监听，才能正确初始化底层SDK实例，可在初始化前添加监听：

  @override
  void initState() {
    super.initState();
    // 提前注册扫描回调
    ZebraScannerPlugin.onScanResult.listen((scanData) {
      // 处理扫描结果
      print(scanData);
    });
  }
  

• 设备与扫描器状态校验
  确认设备支持Zebra RFID扫描功能，且扫描器已通过蓝牙配对或USB连接到设备，处于可被检测状态。

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