升级CN1库FingerprintScanner v15后新安卓设备指纹功能崩溃求助

• 权限适配检查
  新安卓版本（Android 10+）对生物识别权限要求更新，需确保：

  • AndroidManifest中已替换/新增USE_BIOMETRIC或USE_BIOMETRIC_ALTERNATIVES权限（替代旧版USE_FINGERPRINT）
  • 实现运行时权限申请，在调用指纹扫描前主动请求生物识别权限，避免因权限缺失导致崩溃

• 前置设备兼容性校验
  在调用scanFingerprint前，先调用Fingerprint.isFingerprintAuthAvailable()验证设备是否支持生物识别、是否已录入指纹。若未校验直接调用，新设备可能因硬件适配或系统限制触发崩溃

• UI操作线程修正
  安卓禁止非主线程操作UI组件，你的回调代码中直接修改username、password等UI元素，可能在后台线程执行导致崩溃。需将UI操作包裹在EDT（事件调度线程）中：

  Fingerprint.scanFingerprint(value -> {
      EDT.runNow(() -> {
          username.setText(Preferences.get("username", "").trim());
          password.setText(Preferences.get("password", "").trim());
          appNameField.setText(Preferences.get("applicationName", "").toUpperCase().trim());
          authorizeLogin(username, password, appNameField, lastApps);
          revalidate();
      });
  }, (sender, err, errorCode, errorMessage) -> {
      EDT.runNow(() -> {
          ToastBar.showErrorMessage("Finger Print Scan Failed or Cancelled!!", 4000);
      });
  });
  

• Preferences取值安全性增强
  虽然代码中设置了默认空串，但仍需防范潜在空指针风险，可优化取值逻辑：

  // 替换原取值方式
  String usernameVal = Optional.ofNullable(Preferences.get("username")).orElse("").trim();
  username.setText(usernameVal);
  

• 获取崩溃日志定位根源
  抓取具体崩溃栈信息（通过adb logcat或CN1的Log.p工具），明确崩溃类型（如权限异常、线程异常、API调用错误），这是精准排查的核心依据

• 版本兼容性验证
  暂时回退到旧版本FingerPrintScanner测试，若崩溃消失，说明新版本存在兼容性问题，需查看CN1官方更新文档，确认v15的API变更点，调整代码适配新接口

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