Xamarin开发中ZXing扫码功能在iOS设备上无法识别QR码的求助

常见遗漏配置与问题定位 #

你遇到的Android端正常、iOS端扫码无响应的问题，基本都是以下几类配置或实现遗漏导致，按优先级排查即可解决：

• iOS端隐私权限未声明
  iOS系统对摄像头权限的校验是强校验，没有在配置文件中显式声明用途的话，系统会直接静默拦截摄像头调用，不会弹出权限申请弹窗，摄像头预览根本无法启动。
  需要在iOS项目的Info.plist中添加两个核心字段：
  • NSCameraUsageDescription：填写权限申请说明，例如“应用需要调用摄像头完成二维码扫描”
  • NSPhotoLibraryUsageDescription：若涉及从相册选取二维码的场景需补充该字段，部分ZXing版本会触发相册权限校验逻辑，缺省会导致功能阻塞
• 平台层ZXing初始化遗漏
  ZXing组件在Android端会自动完成初始化注册，但iOS端必须手动在平台项目中完成初始化：
  打开iOS项目的AppDelegate.cs，在FinishedLaunching方法中、基础启动逻辑调用完成后，添加初始化代码：

  ZXing.Net.Mobile.Forms.iOS.Platform.Init();
  

  注意要和你安装的NuGet包版本匹配对应命名空间，避免因为程序集加载不匹配导致初始化逻辑根本没生效。
• 代码逻辑的iOS端适配问题
  你提供的两段实现代码，存在几个会导致iOS端功能失效的细节问题：
  1. 推送扫描页之前就手动设置IsTorchOn = true：iOS端摄像头未完成初始化时强制打开闪光灯，会直接导致摄像头预览加载失败，正确的操作是等扫描页完全加载、摄像头启动完成后再操作闪光灯开关
  2. 非主线程操作导航栈：第一段实现的无结果分支中，直接在OnScanResult回调里调用Navigation.PopAsync()，没有用Device.BeginInvokeOnMainThread包裹，iOS端非主线程操作导航逻辑会直接导致页面无响应、扫不出结果
  3. 模态页面层级适配：MobileBarcodeScanner的默认全屏扫描页，在iOS13及以上系统中默认使用卡片式模态呈现，会导致摄像头预览层被遮挡，出现“能弹页面但看不到预览、扫不出码”的情况，需要手动将扫描页的模态呈现样式设置为UIModalPresentationStyle.FullScreen
• NuGet包版本兼容问题
  不要混用不同版本的ZXing相关包：
  • 存在已知bug的2.4.1版本会导致iOS端摄像头黑屏，优先选择2.5.1稳定版或3.1.0正式版，不要混用测试预览版
  • 共享项目、Android项目、iOS项目中安装的ZXing相关NuGet包版本必须完全一致，版本错配会导致平台层绑定失效，iOS端完全无法识别扫码结果

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