使用Kivy+OpenCV开发Android扫码App出现白屏问题求助

权限配置检查 #

• 确认buildozer.spec中权限声明完整，至少包含相机基础权限：

  android.permissions = CAMERA
  

  若涉及扫码结果存储，需追加WRITE_EXTERNAL_STORAGE, READ_EXTERNAL_STORAGE；部分设备需手动在系统设置中确认相机权限是否已开启。

相机索引适配 #

• Android设备的相机索引规则与桌面端不同，默认index=0可能指向前置相机，或部分设备索引逻辑特殊。建议动态获取可用相机列表适配：

  from kivy.core.camera import Camera
  
  camera_ids = Camera.get_camera_ids()
  if camera_ids:
      # 优先选择后置相机（多数设备最后一个索引为后置）
      camera = Camera(index=int(camera_ids[-1]))
  else:
      # 处理无可用相机的提示逻辑
  

依赖与API版本配置 #

• 确保buildozer.spec的依赖项包含扫码和相机所需库，例如使用ZBar扫码需添加：

  requirements = python3,kivy,garden.zbarcam
  

  同时指定兼容的Android API版本，推荐选择29或30版本避免兼容性问题：

  android.api = 30
  

相机预览尺寸兼容 #

• 部分Android设备对自定义预览尺寸有严格限制，需设置设备支持的分辨率：

  from kivy.core.camera.android import AndroidCamera
  
  camera = AndroidCamera(index=0)
  supported_res = camera.get_supported_resolutions()
  if supported_res:
      camera.resolution = supported_res[0]  # 选用设备支持的第一个分辨率
  

布局与渲染问题 #

• 检查相机组件的布局参数，确保未被隐藏或尺寸为0：

  # 示例：让相机组件填满整个父容器
  Camera(size_hint=(1, 1), pos_hint={'x':0, 'y':0})
  

  避免多层布局嵌套导致相机组件被遮挡。

日志精准定位错误 #

• 运行以下命令查看Android设备日志，搜索相机相关报错信息：

  buildozer android logcat
  

  日志中的Camera、Permission、OpenCV等关键词能直接指出问题根源，比如相机初始化失败、权限被拒等。

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