You need to enable JavaScript to run this app. Kivy/Buildozer开发Android应用时ACCESS_SURFACE_FLINGER权限申请问题
优惠活动
大模型
产品
解决方案
定价
更多

Kivy/Buildozer开发Android应用时ACCESS_SURFACE_FLINGER权限申请问题

Buildozer打包Kivy应用启动崩溃修正方案

权限配置的核心错误

  • ACCESS_SURFACE_FLINGER是Android系统级保留权限,仅授予系统桌面、系统UI类核心应用,第三方普通应用无申请资格,android.permissions模块的Permission枚举中根本不包含该属性,你之前写的申请代码会直接触发AttributeError,这是导致应用启动即黑屏崩溃的直接原因。
  • Kivy的UI渲染完全依赖Android普通应用的标准SurfaceView流程,不需要任何和SurfaceFlinger直接交互的特殊权限,你之前看到的相关权限报错是误将系统日志中其他无关进程的报错,当成了自己应用的运行报错。
  • 立刻删除buildozer.spec里所有关于ACCESS_SURFACE_FLINGER的配置项,同时删除main.py中对应申请该权限的代码。

按应用实际功能修正权限配置

结合核心功能(网站信息爬取、JSON本地存储、系统拨号),替换为真实需要的权限配置,在buildozer.spec中设置:

android.permissions = INTERNET, ACCESS_NETWORK_STATE, CALL_PHONE, READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE

对应的main.py权限申请代码,需要增加跨平台兼容判断,避免PC端运行时因为找不到Android专属模块报错:

import os
from kivy.app import App

# 仅在Android平台执行动态权限申请
if 'ANDROID_ARGUMENT' in os.environ:
    from android.permissions import request_permissions, Permission
    request_permissions([
        Permission.CALL_PHONE,
        Permission.READ_EXTERNAL_STORAGE,
        Permission.WRITE_EXTERNAL_STORAGE
    ])

其他导致启动黑屏的常见问题排查

  • 修正JSON文件的存储路径:PC端运行时使用的相对路径,在Android沙盒环境下会指向无权限的系统目录,导致读写失败卡住运行流程,需要将JSON文件的存储路径替换为应用私有目录,示例代码:
    json_save_path = os.path.join(App.get_running_app().user_data_dir, "crawled_data.json")
    
  • 开启明文网络请求支持:如果爬取的网站是HTTP非HTTPS链接,需要在buildozer.spec中配置android.uses_cleartext_traffic = True,否则系统会直接拦截网络请求,导致爬取逻辑卡住,UI无内容加载出现黑屏
  • 打开详细日志输出:在buildozer.spec中设置log_level = 2,打包完成后通过adb工具拉取Python层的真实报错,不要靠系统通用日志判断问题原因

注意:不要为了修报错随意申请和自身功能无关的特殊权限,既过不了应用商店审核,也容易直接触发系统安全拦截导致应用崩溃。

内容的提问来源于stack exchange,提问作者Ghiom

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 06:24:00