Flutter如何让Android自定义外部目录下载的图片视频在系统图库显示

一、Android端基础权限配置 #

• 先在android/app/src/main/AndroidManifest.xml中配置对应权限：
  • 安卓10（API 29）及以上需要在<application>标签中添加属性android:requestLegacyExternalStorage="true"
  • 权限声明示例：

<!-- 安卓12及以下存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- 安卓13及以上媒体权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

• 不要只做静态权限声明，需要配合permission_handler插件动态申请对应权限，确认用户授权通过后再执行文件存储操作。

二、核心操作：通知媒体库扫描新文件 #

文件保存完成后系统媒体库不会自动刷新，你需要主动触发扫描对应文件路径，这是导致图库无法找到文件的核心原因，实现不需要依赖你提到的两个不支持自定义路径的插件，两种可选实现方式：

方式1：自行实现平台通道调用原生扫描 #

• Flutter层调用逻辑：

import 'package:flutter/services.dart';
import 'package:flutter/widgets.dart';

const platform = MethodChannel('com.yourapp/media_scanner');
// 文件保存完成后调用，传入你保存的文件绝对路径
Future<void> scanMediaFile(String filePath) async {
  try {
    await platform.invokeMethod('scanFile', {'path': filePath});
  } catch (e) {
    debugPrint('媒体扫描失败: $e');
  }
}

• 安卓原生层接收逻辑（路径：android/app/src/main/kotlin/你的包名/MainActivity.kt）：

import android.media.MediaScannerConnection
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
  private val CHANNEL = "com.yourapp/media_scanner"

  override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    super.configureFlutterEngine(flutterEngine)
    MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
      if (call.method == "scanFile") {
        val path = call.argument<String>("path")
        if (path != null) {
          MediaScannerConnection.scanFile(this, arrayOf(path), null, null)
          result.success(true)
        } else {
          result.error("INVALID_PATH", "文件路径为空", null)
        }
      } else {
        result.notImplemented()
      }
    }
  }
}

方式2：使用轻量扫描插件 #

如果不想自己写原生代码，可以使用仅做媒体扫描的media_scanner_gallery插件，它完全不干涉你的存储逻辑，支持传入任意自定义路径：

import 'package:media_scanner/media_scanner.dart';

// 文件保存完成后调用，传入自定义路径下的文件绝对路径即可
await MediaScanner.loadMedia(path: yourSavedFileAbsolutePath);

三、额外校验点 #

• 确认你保存的文件后缀名正确，图片需要对应.jpg/.png/.webp等标准后缀，视频需要对应.mp4/.mov等标准后缀，无后缀文件媒体库会识别失败
• 确认你创建的目录不是隐藏目录，不要用.开头命名自定义目录，系统默认不会扫描隐藏目录下的文件
• 安卓13及以上不需要申请管理所有文件的MANAGE_EXTERNAL_STORAGE权限，仅用对应媒体权限即可，避免应用上架被拒

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