Kivy Android：如何将图片直接保存至系统相册而非Pictures目录？

直接使用export_to_png保存到/sdcard/Pictures/后，文件会出现在文件管理器，但系统相册不会自动识别——因为Android需要媒体扫描器更新媒体数据库，或者直接通过MediaStore写入媒体库（适配Android 10+的Scoped Storage）。以下是两种可行方案：

方案1：通知媒体扫描器识别已保存的图片 #

这种方法适合继续使用原有export_to_png逻辑，只需添加扫描通知步骤：

步骤1：添加权限 #

在buildozer.spec中配置必要权限：

android.permissions = WRITE_EXTERNAL_STORAGE, READ_EXTERNAL_STORAGE

步骤2：实现媒体扫描函数 #

在Python主文件中添加扫描函数（需依赖pyjnius，buildozer会自动处理依赖）：

from kivy.utils import platform
if platform == 'android':
    from jnius import autoclass

def scan_media_file(file_path):
    if platform != 'android':
        return
    # 调用Android原生媒体扫描接口
    MediaScannerConnection = autoclass('android.media.MediaScannerConnection')
    PythonActivity = autoclass('org.kivy.android.PythonActivity')
    context = PythonActivity.mActivity.getApplicationContext()
    
    MediaScannerConnection.scanFile(
        context,
        [file_path],
        ['image/png'],
        None
    )

将此函数挂载到App类中，方便kv文件调用：

from kivy.app import App

class MyApp(App):
    def scan_media_file(self, file_path):
        scan_media_file(file_path)

步骤3：修改kv文件 #

保存图片后立即调用扫描函数：

on_press:
    root.export_to_png("/sdcard/Pictures/Image.png")
    app.scan_media_file("/sdcard/Pictures/Image.png")

方案2：直接通过MediaStore写入系统相册（推荐Android 10+） #

针对Android 10及以上的Scoped Storage限制，直接写入MediaStore无需额外扫描，也避免权限问题：

步骤1：实现MediaStore写入函数 #

from kivy.utils import platform
from io import BytesIO
if platform == 'android':
    from jnius import autoclass

def save_to_media_store(png_data, file_name="Image.png"):
    if platform != 'android':
        return False
    # 初始化Android原生类
    ContentResolver = autoclass('android.content.ContentResolver')
    ContentValues = autoclass('android.content.ContentValues')
    MediaStore = autoclass('android.provider.MediaStore')
    PythonActivity = autoclass('org.kivy.android.PythonActivity')
    context = PythonActivity.mActivity.getApplicationContext()
    resolver = context.getContentResolver()

    # 配置图片元数据
    values = ContentValues()
    values.put(MediaStore.Images.Media.DISPLAY_NAME, file_name)
    values.put(MediaStore.Images.Media.MIME_TYPE, 'image/png')
    # 适配Android Q+的相对路径
    if int(autoclass('android.os.Build$VERSION').SDK_INT) >= 29:
        values.put(MediaStore.Images.Media.RELATIVE_PATH, 'Pictures')

    # 插入到媒体库并获取URI
    uri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values)
    if not uri:
        return False
    # 写入图片数据
    try:
        output_stream = resolver.openOutputStream(uri)
        output_stream.write(png_data)
        output_stream.close()
        return True
    except Exception:
        resolver.delete(uri, None, None)
        return False

步骤2：修改Widget类的导出逻辑 #

在自定义Widget中添加导出到媒体库的方法：

from kivy.uix.widget import Widget

class MyWidget(Widget):
    def export_to_media_store(self):
        # 获取Widget的PNG字节数据
        buffer = BytesIO()
        self.export_to_png(buffer)
        buffer.seek(0)
        png_data = buffer.read()
        # 保存到系统相册
        success = save_to_media_store(png_data)
        print("保存成功" if success else "保存失败")

步骤3：修改kv文件 #

直接调用新的导出方法：

on_press: root.export_to_media_store()

注意事项 #

• Android 11+若使用方案1，可能需要额外添加MANAGE_EXTERNAL_STORAGE权限，且需用户手动在设置中开启；方案2无需此权限。
• 测试需在真实Android设备或完整配置的模拟器上进行，部分模拟器的媒体库刷新可能有延迟。

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