Flutter如何获取存储设备的最顶层根目录？

我之前在开发Flutter应用时也碰到过一模一样的问题——path_provider只能拿到应用相关的目录，完全满足不了访问系统存储根目录的需求。下面给你分享几个靠谱的解决思路：

1. 通过Platform Channel调用原生Android代码 #

Flutter本身没有提供直接获取/storage根目录的API，所以最稳妥的方式是借助原生Android的能力，再通过Platform Channel把结果传给Flutter端。

Android端（Kotlin代码） #

在你的Android项目的MainActivity.kt里添加方法：

import android.os.Environment
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.example.storage/storage_root"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "getStorageRoot") {
                val externalStorageDir = Environment.getExternalStorageDirectory()
                val storageRoot = externalStorageDir.parentFile?.absolutePath
                if (storageRoot != null) {
                    result.success(storageRoot)
                } else {
                    result.error("ERROR", "Failed to get storage root", null)
                }
            } else {
                result.notImplemented()
            }
        }
    }
}

Flutter端调用代码 #

import 'package:flutter/services.dart';

class StorageRootProvider {
  static const MethodChannel _channel = MethodChannel('com.example.storage/storage_root');

  static Future<String?> getStorageRoot() async {
    try {
      final String? result = await _channel.invokeMethod('getStorageRoot');
      return result;
    } on PlatformException catch (e) {
      print("Failed to get storage root: ${e.message}");
      return null;
    }
  }
}

调用的时候直接用await StorageRootProvider.getStorageRoot()就能拿到/storage路径了。

2. 使用第三方包简化操作 #

如果你不想写原生代码，可以试试ext_storage这个第三方包，它能帮你快速获取外部存储的根目录，然后我们再通过路径处理拿到父级的/storage：

首先添加依赖到pubspec.yaml：

dependencies:
  ext_storage: ^1.0.3

然后在Flutter代码里处理：

import 'package:ext_storage/ext_storage.dart';
import 'package:path/path.dart' as path;

Future<String?> getStorageRoot() async {
  String externalDir = await ExtStorage.getExternalStorageDirectory();
  // 获取外部存储目录的父级，也就是/storage
  return path.dirname(externalDir);
}

3. 注意权限与设备适配问题 #

• Android权限：如果你的应用需要访问/storage下的任意目录，在Android 10（API 29）及以上，需要申请MANAGE_EXTERNAL_STORAGE权限，并且引导用户手动在设置里开启这个权限。你可以在AndroidManifest.xml里添加权限声明：

  <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
  

• 多存储设备适配：有些设备可能插了SD卡，/storage下会有多个子目录（比如/storage/emulated/0、/storage/sdcard1），你可以遍历/storage目录下的子文件夹，判断哪些是可读写的存储设备。
• iOS限制：iOS出于沙盒机制，完全禁止应用访问系统级的根目录，所以这个需求在iOS上是无法实现的，只能访问应用自己的沙盒目录。

关于硬编码路径的问题 #

你担心的硬编码问题确实存在，但/storage这个路径在绝大多数Android设备上是通用的，不过还是更推荐通过原生方法或者第三方包动态获取，避免极少数定制化设备的适配问题。

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