使用Kivy开发安卓应用调用前置摄像头Buildozer打包APK崩溃求助

安全阿岳

2026-8-26

崩溃原因

Kivy文档给出的index=0对应后置、index=1对应前置是通用场景下的参考映射，并非所有安卓设备都遵循该规则。当前多数多摄安卓机（搭载广角、微距、景深镜头的机型）、定制ROM机型的摄像头ID分配逻辑并不统一，部分设备前置摄像头的ID可能为2、3甚至其他数值，硬编码index=1会直接尝试访问不存在或无访问权限的摄像头节点，触发系统级闪退，不会抛出Python层可捕获的异常。
Buildozer默认打包配置缺失前置摄像头相关声明。Android 10及以上版本对硬件访问的校验更严格，仅配置基础相机权限、未声明前置摄像头硬件特性时，调用前置摄像头的请求会被系统直接拦截，导致应用崩溃。
旧版本Kivy的安卓摄像头实现存在逻辑缺陷：2.0.0以下版本的Kivy Camera组件未做摄像头ID存在性校验，传入无效index时会直接触发native层崩溃，没有容错处理。

解决步骤

第一步：修改Buildozer配置，补全权限与硬件声明
打开项目根目录下的buildozer.spec文件，调整以下配置项：

# 配置相机权限
android.permissions = CAMERA
# 声明应用需要用到相机、前置摄像头硬件特性
android.features = android.hardware.camera, android.hardware.camera.front
# 将最低支持安卓版本设为21（Android 5.0），适配camera2 API的枚举逻辑
android.minapi = 21

配置修改完成后，必须先执行buildozer android clean清理历史打包缓存，再重新执行打包命令，否则旧配置缓存不会生效。

第二步：动态枚举设备摄像头ID，不要硬编码index
不要直接写死index=1，通过Pyjnius调用安卓原生Camera2 API枚举所有可用摄像头，匹配到前置摄像头对应的ID后，再传入Camera组件初始化，参考实现代码：

from kivy.app import App
from kivy.uix.camera import Camera
from jnius import autoclass

# 导入安卓原生API类
CameraManager = autoclass('android.hardware.camera2.CameraManager')
PythonActivity = autoclass('org.kivy.android.PythonActivity')

def fetch_front_camera_id():
    """遍历设备摄像头列表，返回前置摄像头ID，获取失败则默认返回后置ID 0"""
    try:
        app_context = PythonActivity.mActivity.getApplicationContext()
        cam_manager = app_context.getSystemService(app_context.CAMERA_SERVICE)
        all_cam_ids = cam_manager.getCameraIdList()
        for cam_id in all_cam_ids:
            cam_info = cam_manager.getCameraCharacteristics(cam_id)
            lens_direction = cam_info.get(cam_info.LENS_FACING)
            if lens_direction == cam_info.LENS_FACING_FRONT:
                return int(cam_id)
    except Exception as e:
        print(f"枚举前置摄像头失败，回退到后置摄像头: {str(e)}")
    return 0

class FrontCameraDemo(App):
    def build(self):
        front_cam_index = fetch_front_camera_id()
        camera_view = Camera(index=front_cam_index, play=True)
        return camera_view

if __name__ == "__main__":
    FrontCameraDemo().run()

第三步：版本与权限适配
- 将Kivy升级到2.0.0及以上稳定版本，修复旧版本对camera2 API的适配bug，避免无效index触发native层崩溃。
- 适配Android 12及以上版本的动态权限逻辑：应用启动后先主动弹出相机权限申请，用户授权通过后再初始化Camera组件，避免静态权限不生效导致的崩溃。

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