Kivy-Android文件读取问题：如何解决Android存储访问以打开任意类型文件

1. 理解Android 10+的分区存储限制 #

从Android 10开始，系统启用分区存储机制，普通的READ_EXTERNAL_STORAGE权限仅能访问媒体文件（图片、音频、视频）和下载目录内的文件。要访问任意类型文件，必须使用存储访问框架(SAF)，而非依赖传统权限请求。

2. 用SAF实现任意文件选择（Python场景） #

如果是基于Kivy/PyInstaller/Buildozer打包的应用，直接通过pyjnius调用Android原生SAF API是最可靠的方案：

步骤1：代码中触发SAF文件选择器 #

from jnius import autoclass, cast
from android import activity

def open_any_file():
    Intent = autoclass('android.content.Intent')
    Activity = autoclass('android.app.Activity')
    
    # 创建ACTION_OPEN_DOCUMENT意图，支持任意文件
    intent = Intent(Intent.ACTION_OPEN_DOCUMENT)
    intent.addCategory(Intent.CATEGORY_OPENABLE)
    # 设置MIME类型为*/*，允许所有文件类型
    intent.setType("*/*")
    
    # 启动选择器并等待结果
    activity.startActivityForResult(intent, 1001)

# 处理选择结果
def handle_file_result(request_code, result_code, intent):
    if request_code == 1001 and result_code == Activity.RESULT_OK:
        if intent is not None:
            file_uri = intent.getData()
            # 通过ContentResolver读取文件内容
            resolver = cast('android.content.ContentResolver', activity.getApplicationContext().getContentResolver())
            input_stream = resolver.openInputStream(file_uri)
            # 示例：读取文本内容
            file_content = input_stream.read().decode('utf-8')
            input_stream.close()
            # 此处添加文件内容的处理逻辑...

# 注册结果回调
activity.bind(on_activity_result=handle_file_result)

步骤2：配置清单与权限 #

在.spec或AndroidManifest.xml中补充必要配置：

<!-- 无需READ_EXTERNAL_STORAGE，SAF不依赖此权限 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" android:maxSdkVersion="30"/>

<!-- 针对Android 10可选添加，兼容旧存储逻辑 -->
<application ... android:requestLegacyExternalStorage="true">

3. 简化方案：使用KivyMD的文件管理器（若用KivyMD） #

KivyMD的MDFileManager已适配SAF，配置更简洁：

from kivymd.app import MDApp
from kivymd.uix.filemanager import MDFileManager
from kivymd.toast import toast

class FilePickerApp(MDApp):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.file_manager = MDFileManager(
            exit_manager=self.close_manager,
            select_path=self.on_file_selected,
            ext=['*']  # 允许所有文件类型
        )

    def open_picker(self):
        self.file_manager.show('/')

    def on_file_selected(self, file_path):
        self.close_manager()
        toast(f"选中文件：{file_path}")
        # 处理选中文件逻辑...

    def close_manager(self, *args):
        self.file_manager.close()

注意：Buildozer配置中需添加kivymd依赖：requirements = python3,kivy,kivymd

4. 常见问题排查 #

• 不要尝试直接访问/sdcard路径：分区存储下应用无直接访问权限，必须通过SAF或MediaStore操作。
• 放弃依赖READ_EXTERNAL_STORAGE访问非媒体文件：Android 10+该权限对非媒体文件无效。
• 确保pyjnius依赖已正确添加：Buildozer或PyInstaller打包时需包含该库。

内容的提问来源于stack exchange，提问作者TD-DEV