Flutter项目集成card_scanner卡片扫描包报错及兼容性问题咨询

常见兼容性问题 #

• Flutter版本适配问题：当前主流稳定版card_scanner最低支持Flutter 2.10.0+，低于该版本的Flutter项目引入时会直接报依赖冲突。部分最新版card_scanner仅支持Flutter 3.0+，老版本Flutter项目引入会直接编译失败。
• 原生平台权限兼容问题：
• Android端：card_scanner依赖相机权限，Android 13+系统需要动态申请android.permission.CAMERA权限，未配置的情况下启动扫描会直接崩溃；如果项目targetSdkVersion低于31，引入高版本card_scanner的CameraX依赖会出现编译报错。
• iOS端：需要在Info.plist中配置NSCameraUsageDescription权限说明，未配置时调用扫描功能会直接闪退；iOS 15以下系统使用部分高版本card_scanner会出现识别无响应的问题。
• 第三方依赖冲突：如果项目中已经引入camera、google_mlkit_text_recognition等相机、文字识别相关依赖，很容易和card_scanner内置的依赖出现版本冲突，导致编译失败。

解决建议 #

• 版本匹配调整：
• 先确认项目的Flutter版本，选择对应适配的card_scanner版本：Flutter 2.x项目推荐使用card_scanner: ^0.2.1，Flutter 3.x项目可以使用最新稳定版card_scanner: ^0.6.0。
• 如果依然出现依赖冲突，可以在pubspec.yaml中添加dependency_overrides配置，强制指定冲突依赖的统一版本，示例配置如下：

  dependency_overrides:
    camera: ^0.10.5+5
    google_mlkit_text_recognition: ^0.8.0
  

• 原生配置优化：
• Android端：在android/app/src/main/AndroidManifest.xml中添加相机权限声明，如果targetSdkVersion低于31，可以将card_scanner版本降到0.3.0以下，或者直接升级targetSdkVersion到33即可解决编译问题。
• iOS端：在ios/Runner/Info.plist中添加相机权限使用说明，将项目最低支持iOS版本调整到12.0以上；如果需要兼容iOS 15以下系统，使用0.4.0以下版本的card_scanner即可。
• 功能调用优化：
• 调用扫描功能前先主动申请相机权限，确认权限授权通过后再打开扫描页面，避免权限不足导致的闪退问题。
• 如果出现卡片识别率低的问题，尽量将扫描框尺寸和官方示例保持一致，避免自定义扫描框过小导致识别失败。

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