Kivy Launcher在Android 11上无法识别项目无法启动如何解决？

原因说明 #

Android 11 对外部存储访问权限做了限制，旧版Kivy Launcher默认仅持有媒体文件访问权限，无法读取sdcard下的普通文件目录，是出现该报错的主要原因。

排查步骤 #

• 首先检查应用权限：长按Kivy Launcher图标进入应用信息页，打开权限管理，将存储权限设置为允许访问所有文件，不可仅授予媒体文件访问权限。
• 检查目录结构与文件规范：
  • 确保文件路径为 sdcard/kivy/[你的应用文件夹名]/main.py，不要将main.py直接放在kivy根目录，也不要嵌套多层子文件夹
  • 确认文件名为全小写的main.py和android.txt，大小写错误会导致识别失败
  • android.txt内容需严格遵循格式，不要带多余空格、空行，示例格式如下：

appname=测试应用
package=org.test.myapp
version=1.0

• 若上述操作无效，可确认你使用的Kivy Launcher是否适配Android 11+系统，旧版Launcher未适配新存储权限规则，也可直接用Buildozer将项目打包为独立APK安装运行，绕过Launcher的限制。

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