Kivy打包为APK后点击按钮无法加载显示本地图片问题

你遇到的问题是Kivy在安卓平台动态加载外部存储资源的典型兼容性问题，核心原因有三个：

• 安卓高版本（10+）的分层权限校验：应用启动初始化阶段的存储访问已经通过权限校验，点击事件属于后续异步触发的行为，部分系统会对这类异步的外部存储访问做二次拦截，哪怕你已经手动开启了权限
• 动态创建的Image组件未主动触发渲染：静态添加的Image会在布局初始化阶段自动完成纹理加载和尺寸适配，动态新增的组件如果没有显式配置适配规则、没有强制触发资源加载，大概率会出现无显示的问题
• 布局清空后新增组件的尺寸适配问题：你调用clear_widgets()后新增的Image默认没有绑定父布局的尺寸规则，会出现组件大小为0、视觉上看不见的情况

1. 先调整buildozer.spec权限配置 #

针对安卓11及以上版本，补充完整权限声明：

android.permissions = READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE, MANAGE_EXTERNAL_STORAGE
android.api = 33
android.requestStorageAccess = True

2. 修改业务代码 #

调整点击回调逻辑，给动态创建的Image添加尺寸适配规则、强制触发图片加载：

from kivy.app import App
from kivy.uix.button import Button
from kivy.uix.image import Image
from kivy.uix.gridlayout import GridLayout

class m(App):
    def build(self):
        self.g=GridLayout(cols=1)
        self.b=Button(text="push")
        def push(btn):
            # 配置Image的尺寸适配规则，跟随父布局大小
            i=Image(
                source="/storage/emulated/0/im.png",
                size_hint=(1,1),
                allow_stretch=True,
                keep_ratio=True
            )
            self.g.clear_widgets()
            self.g.add_widget(i)
            # 强制刷新图片加载，绕过Kivy的缓存机制
            i.reload()
        self.b.bind(on_press=push)
        self.g.add_widget(self.b)
        return self.g

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

可选验证方案 #

如果以上修改还是不行，可以先把测试图片放到应用的私有资源目录（和main.py同目录），修改source路径为相对路径"im.png"，打包时把图片加到buildozer.spec的android.add_assets规则中，验证动态加载逻辑是否正常，排除路径或权限的额外影响。

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