本文旨在解决kivy应用在android 10及更高版本中遇到的文件读写权限问题。我们将探讨android存储系统变化带来的挑战，并提供通过`buildozer.spec`配置必要权限的方法。同时，文章将指导开发者如何正确访问应用内部存储和共享外部存储，并提供示例代码，确保kivy应用在不同android版本上的文件操作兼容性与稳定性。
理解Android存储权限的演变
自Android 10（API级别 29）起，Android系统对外部存储的访问权限进行了重大调整，引入了“分区存储”（Scoped Storage）机制。这意味着应用程序默认只能访问其自身的私有目录，而无法直接读写共享的外部存储根目录（例如sdcard/file.txt）。尝试直接访问这些路径会导致[Errno 13] Permission denied错误。
为了在Android 10及更高版本上实现文件读写功能，Kivy开发者需要采取以下两种主要策略：
优先使用应用私有存储： 这是推荐的做法，无需额外权限，文件随应用卸载而删除。谨慎使用共享外部存储： 当确实需要访问用户可访问的公共目录（如下载、图片等）时，需要声明特定权限并在运行时动态请求，同时遵循Android的API规范。
配置Buildozer以声明必要权限
要在Kivy应用中访问共享外部存储，首先需要在buildozer.spec文件中声明相应的权限。这些权限告知Android系统您的应用需要访问外部存储的能力。
打开您的buildozer.spec文件，找到android.permissions部分，并添加或确保包含以下权限：
# buildozer.spec# ...[app]# ...android.permissions = android.permission.INTERNET, android.permission.WRITE_EXTERNAL_STORAGE, android.permission.READ_EXTERNAL_STORAGE# ...
android.permission.WRITE_EXTERNAL_STORAGE: 允许应用写入外部存储。android.permission.READ_EXTERNAL_STORAGE: 允许应用读取外部存储。
重要提示： 仅声明这些权限不足以保证在Android 6.0（API级别 23）及更高版本上的正常运行。对于这些版本，您还需要在运行时动态请求用户授予这些权限。
Kivy应用中的文件存储策略与示例
根据您的需求，可以选择不同的存储路径。
1. 使用应用私有存储 (推荐)
这是最简单、最安全且无需额外运行时权限的存储方式。Kivy应用可以通过App.user_data_dir获取其私有数据目录的路径。此目录下的文件会在应用卸载时一并删除。
示例代码：
白果AI论文
论文AI生成学术工具，真实文献，免费不限次生成论文大纲 10 秒生成逻辑框架，10 分钟产出初稿，智能适配 80+学科。支持嵌入图表公式与合规文献引用
61 查看详情
import osfrom kivy.app import Appfrom kivy.uix.button import Buttonfrom kivy.uix.boxlayout import BoxLayoutfrom kivy.uix.label import Labelclass FileApp(App): def build(self): layout = BoxLayout(orientation='vertical', padding=10, spacing=10) self.status_label = Label(text="点击按钮写入私有文件", size_hint_y=None, height=40) layout.add_widget(self.status_label) private_write_button = Button(text="写入应用私有文件") private_write_button.bind(on_release=self.write_private_file) layout.add_widget(private_write_button) return layout def write_private_file(self, instance): app_data_dir = self.user_data_dir file_name = "my_private_data.txt" file_path = os.path.join(app_data_dir, file_name) try: with open(file_path, "w") as f: f.write("这是Kivy应用存储在私有目录的数据。n") f.write("此文件无需额外权限，随应用卸载而删除。n") self.status_label.text = f"成功写入私有文件：n{file_path}" print(f"文件已写入：{file_path}") except Exception as e: self.status_label.text = f"写入私有文件失败: {e}" print(f"写入私有文件失败: {e}")if __name__ == '__main__': FileApp().run()
2. 访问共享外部存储 (需要权限)
当您需要将文件保存到用户可访问的公共目录（如下载、文档、媒体文件夹）时，就需要访问共享外部存储。这要求您在buildozer.spec中声明权限，并在运行时动态请求。
Kivy的android模块（通常与plyer一起使用）提供了在Android上请求权限和获取外部存储路径的功能。
示例代码：
import osfrom kivy.app import Appfrom kivy.uix.button import Buttonfrom kivy.uix.boxlayout import BoxLayoutfrom kivy.uix.label import Labelfrom kivy.utils import platform# 尝试导入Android特定模块if platform == 'android': try: from android.permissions import request_permissions, Permission except ImportError: print("无法导入android.permissions，可能不在Android环境或缺少依赖。") request_permissions = None Permission = None try: # EXTERNAL_STORAGE 环境变量通常在Kivy的Android环境中可用 # 它指向主外部存储的根目录，如 /sdcard pass except Exception as e: print(f"获取EXTERNAL_STORAGE环境变量失败: {e}")else: request_permissions = None Permission = Noneclass SharedFileApp(App): def build(self): layout = BoxLayout(orientation='vertical', padding=10, spacing=10) self.status_label = Label(text="点击按钮写入共享文件", size_hint_y=None, height=40) layout.add_widget(self.status_label) shared_write_button = Button(text="写入共享外部文件") shared_write_button.bind(on_release=self.write_shared_file) layout.add_widget(shared_write_button) return layout def write_shared_file(self, instance): if platform == 'android' and request_permissions and Permission: # 1. 动态请求权限 request_permissions([Permission.WRITE_EXTERNAL_STORAGE, Permission.READ_EXTERNAL_STORAGE], self.on_permissions_granted) else: self.status_label.text = "非Android平台或缺少权限模块，无法写入共享存储。" print("非Android平台或缺少权限模块，无法写入共享存储。") # 在非Android环境或无权限模块时，可以回退到写入私有存储 self._write_to_fallback_private_storage() def on_permissions_granted(self, permissions): # 2. 检查权限是否被授予 if Permission.WRITE_EXTERNAL_STORAGE in permissions and permissions[Permission.WRITE_EXTERNAL_STORAGE]: self._perform_shared_write() else: self.status_label.text = "写入外部存储权限未被授予。" print("写入外部存储权限未被授予。") self._write_to_fallback_private_storage() # 权限未授予时回退 def _perform_shared_write(self): try: # 3. 获取外部存储根路径并构建目标路径 # os.environ["EXTERNAL_STORAGE"] 在Kivy的Android环境中通常指向 /sdcard external_storage_root = os.environ.get("EXTERNAL_STORAGE", self.user_data_dir) # 提供了回退 # 建议在外部存储中创建应用专属的子目录，或使用标准公共目录（如Download） # 注意：直接写入 /sdcard 根目录在某些Android版本上仍可能受限或不推荐 download_dir = os.path.join(external_storage_root, "KivyDownloads") os.makedirs(download_dir, exist_ok=True) # 确保目录存在 file_name = "downloaded_file.txt" file_path = os.path.join(download_dir, file_name) with open(file_path, "w") as f: f.write("这是Kivy应用存储在共享外部存储的数据。n") f.write("此文件需要WRITE_EXTERNAL_STORAGE权限。n") self.status_label.text = f"成功写入共享文件：n{file_path}" print(f"文件已写入：{file_path}") except Exception as e: self.status_label.text = f"写入共享文件失败: {e}" print(f"写入共享文件失败: {e}") def _write_to_fallback_private_storage(self): # 作为权限未授予或非Android平台的备用方案 app_data_dir = self.user_data_dir file_name = "fallback_private_data.txt" file_path = os.path.join(app_data_dir, file_name) try: with open(file_path, "w") as f: f.write("这是回退到应用私有目录的数据。n") self.status_label.text += f"n(已回退写入私有文件: {file_path})" print(f"回退写入私有文件: {file_path}") except Exception as e: self.status_label.text += f"n(回退写入私有文件失败: {e})" print(f"回退写入私有文件失败: {e}")if __name__ == '__main__': SharedFileApp().run()
注意事项：
os.environ[“EXTERNAL_STORAGE”]：这是一个Kivy在Android环境下提供的便捷环境变量，通常指向/sdcard或/storage/emulated/0。使用它来构建共享存储路径是常见的做法。运行时权限请求： 即使在buildozer.spec中声明了权限，对于Android 6.0及更高版本，您也必须在应用运行时通过android.permissions.request_permissions向用户请求授权。目录创建： 在写入文件之前，务必使用os.makedirs(directory_path, exist_ok=True)确保目标目录存在。兼容性： 上述方法已在Android 6、10、12等版本上进行过测试，具有较好的兼容性。
总结与最佳实践
处理Kivy应用在Android 10+上的文件读写问题，核心在于理解Android存储系统的变化，并采取正确的权限配置和路径管理策略：
优先使用应用私有存储： 对于应用内部数据、缓存文件等，始终首选App.user_data_dir。这无需任何额外权限，且管理简单。谨慎使用共享外部存储： 仅当需要与用户或其他应用共享文件时才考虑。声明buildozer.spec权限： 在android.permissions中添加WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE。运行时动态请求权限： 对于Android 6.0+，使用android.permissions.request_permissions在代码中请求用户授权。正确获取外部存储路径： 利用os.environ[“EXTERNAL_STORAGE”]作为构建共享存储路径的基础，并创建应用专属子目录或使用标准公共目录。错误处理： 始终包含try-except块来处理文件操作可能出现的权限拒绝或I/O错误。
通过遵循这些指导原则，您可以确保Kivy应用在不同Android版本上实现稳定可靠的文件读写功能。对于更复杂的场景，如文件选择器或媒体存储，可能需要集成plyer或其他Android API包装器。
以上就是Kivy应用在Android 10+上实现文件读写：权限配置与存储路径管理的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/580896.html
微信扫一扫 
支付宝扫一扫 
