Buildozer编译Kivy+OpenCV手机推流应用启动崩溃问题排查

一、修正Buildozer.spec配置 #

原配置存在依赖版本不明确、权限不足、编译环境参数缺失等问题，以下是经过验证的完整配置：

[app]
title = CamStreamApp
package.name = camstream
package.domain = org.example
source.dir = .
source.include_exts = py,png,jpg,kv,atlas
version = 0.1

requirements = python3,kivy==2.2.1,opencv==4.5.5
android.api = 33
android.ndk = 25b
android.sdk = 24
android.permissions = CAMERA,INTERNET
android.archs = arm64-v8a, armeabi-v7a
android.add_android_assets = True
android.buildtools = 30.0.3
android.use_aapt2 = True

配置说明：

• 指定Kivy和OpenCV的稳定兼容版本，避免版本冲突
• 明确安卓API、NDK、SDK版本，确保编译环境与设备兼容
• 补充INTERNET权限（为后续推流预留，同时避免潜在权限触发的闪退）
• 开启资源打包参数，确保依赖文件正确嵌入APK

二、代码适配与错误处理 #

原代码缺少摄像头初始化校验、异常处理，且存在Python3语法兼容问题，修改后的代码如下：

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.image import Image
from kivy.clock import Clock
from kivy.graphics.texture import Texture
import cv2
from kivy.logger import Logger

class CamApp(App):
    def build(self):
        self.img1 = Image()
        layout = BoxLayout()
        layout.add_widget(self.img1)
        # 指定安卓摄像头驱动，提升设备兼容性
        self.capture = cv2.VideoCapture(0, cv2.CAP_ANDROID)
        # 校验摄像头是否成功打开
        if not self.capture.isOpened():
            Logger.error("CAMERA: Failed to access camera!")
            return layout
        # 降低帧率减少性能负载
        Clock.schedule_interval(self.update, 1.0 / 20.0)
        return layout

    def update(self, dt):
        ret, frame = self.capture.read()
        # 校验帧读取状态，避免空指针异常
        if not ret or frame is None:
            Logger.warning("CAMERA: Failed to read frame!")
            return
        
        cv2.line(frame, (10,10),(50,50),(0,0,255),5)

        buf1 = cv2.flip(frame, 0)
        buf = buf1.tobytes()  # 替换tostring()适配Python3字节类型
        texture1 = Texture.create(size=(frame.shape[1], frame.shape[0]), colorfmt='bgr')
        texture1.blit_buffer(buf, colorfmt='bgr', bufferfmt='ubyte')

        self.img1.texture = texture1

    def on_stop(self):
        # 应用退出时释放摄像头资源
        if self.capture.isOpened():
            self.capture.release()

if __name__ == '__main__':
    CamApp().run()

代码修改点：

• 使用cv2.CAP_ANDROID指定安卓原生摄像头驱动
• 添加摄像头打开状态、帧读取的校验逻辑，避免空值引发闪退
• 替换buf1.tostring()为buf1.tobytes()，适配Python3语法
• 添加资源释放逻辑，避免后台资源泄漏
• 降低帧率至20fps，减轻设备性能压力

三、编译执行步骤 #

1. 安装Ubuntu环境依赖：

sudo apt update
sudo apt install -y git zip unzip openjdk-17-jdk python3-pip autoconf libtool pkg-config zlib1g-dev libncurses5-dev libncursesw5-dev libtinfo5 cmake libffi-dev libssl-dev
pip3 install --user buildozer

2. 清理旧编译缓存（必须执行，避免旧文件干扰）：

buildozer android clean

3. 执行编译：

buildozer -v android debug

4. 部署到连接的安卓设备：

buildozer android deploy run

四、闪退排查技巧 #

如果仍出现闪退，通过以下命令查看安卓日志定位错误：

adb logcat | grep python

• 确认设备安卓版本不低于8.0（API 24）
• 检查设备是否已授予应用摄像头权限
• 验证编译环境的NDK、SDK版本与配置一致

内容的提问来源于stack exchange，提问作者황현후