Xamarin Forms/.NET MAUI Android获取外部文件信息失败的解决方案咨询

Android 10引入的**分区存储（Scoped Storage）**彻底改变了应用访问外部存储的规则：

• 即使申请了READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE权限，Android 10+（尤其是Android 11及以上）也禁止应用直接通过文件路径访问沙箱外的文件夹/文件，Directory.GetFiles、Directory.EnumerateFiles这类基于绝对路径的API会返回空数组，因为系统不再赋予应用直接访问的权限。
• 旧应用之前能正常运行，大概率是因为targetSdkVersion低于29，或者在AndroidManifest.xml中配置了android:requestLegacyExternalStorage="true"，但这个配置在Android 11+完全失效，Android 13+会被系统忽略。
• Android 13+进一步拆分了存储权限，READ_MEDIA_*系列权限仅针对媒体文件，对于备份文件这类非媒体文件，依然无法通过路径直接访问。

方案1：直接使用Storage Access Framework（SAF）实现 #

SAF是官方推荐的跨版本解决方案，通过让用户主动选择文件夹，获取该文件夹的访问权限，再通过DocumentFileAPI遍历文件。

步骤1：定义跨平台接口 #

在Xamarin Forms项目中定义接口：

public interface IFolderFileService
{
    Task<List<BackupFileInfo>> GetFilesFromSelectedFolderAsync();
}

// 你的备份文件信息类
public class BackupFileInfo
{
    public string Name { get; set; }
    public long Length { get; set; }
    public string FileUri { get; set; } // 用于后续文件操作的Uri
}

步骤2：Android平台实现接口 #

在Android子项目中实现接口，处理SAF的Intent回调：

[assembly: Dependency(typeof(FolderFileService))]
namespace YourAppName.Droid.Services
{
    public class FolderFileService : IFolderFileService, IActivityResultCallback
    {
        private TaskCompletionSource<List<BackupFileInfo>> _taskSource;
        private const int FolderPickRequestCode = 1001;

        public Task<List<BackupFileInfo>> GetFilesFromSelectedFolderAsync()
        {
            _taskSource = new TaskCompletionSource<List<BackupFileInfo>>();
            var currentActivity = Platform.CurrentActivity;

            // 启动SAF文件夹选择界面
            var pickFolderIntent = new Intent(Intent.ActionOpenDocumentTree);
            currentActivity.StartActivityForResult(pickFolderIntent, FolderPickRequestCode);

            return _taskSource.Task;
        }

        public void OnActivityResult(int requestCode, Result resultCode, Intent data)
        {
            if (requestCode != FolderPickRequestCode || resultCode != Result.Ok || data == null)
            {
                _taskSource.SetResult(new List<BackupFileInfo>());
                return;
            }

            var folderUri = data.Data;
            // 持久化权限，下次启动无需重新选择
            Platform.CurrentActivity.ContentResolver.TakePersistableUriPermission(
                folderUri,
                ActivityFlags.GrantReadUriPermission);

            var rootDoc = DocumentFile.FromTreeUri(Platform.CurrentActivity, folderUri);
            var fileList = new List<BackupFileInfo>();

            // 遍历文件夹内的文件
            foreach (var docFile in rootDoc.ListFiles())
            {
                if (docFile.IsFile)
                {
                    // 通过Uri获取文件大小
                    long fileSize = -1;
                    using (var inputStream = Platform.CurrentActivity.ContentResolver.OpenInputStream(docFile.Uri))
                    {
                        fileSize = inputStream.Length;
                    }

                    fileList.Add(new BackupFileInfo
                    {
                        Name = docFile.Name,
                        Length = fileSize,
                        FileUri = docFile.Uri.ToString()
                    });
                }
            }

            _taskSource.SetResult(fileList);
        }
    }
}

步骤3：Xamarin Forms中调用 #

在共享项目的业务逻辑中调用接口：

var fileService = DependencyService.Get<IFolderFileService>();
var backupFiles = await fileService.GetFilesFromSelectedFolderAsync();

// 处理文件列表
foreach (var file in backupFiles)
{
    System.Diagnostics.Debug.WriteLine($">>> fi.Name = {file.Name}");
    System.Diagnostics.Debug.WriteLine($">>> fi.Length = {file.Length}");
    System.Diagnostics.Debug.WriteLine(">>> ---------------------------");
}

方案2：使用封装好的NuGet包简化开发 #

如果不想手动实现SAF逻辑，可以使用成熟的NuGet包，比如Plugin.DocumentPicker，它已经封装了SAF的核心逻辑，支持跨平台选择文件夹和文件。

步骤1：安装NuGet包 #

在Xamarin Forms项目和Android子项目中安装Plugin.DocumentPicker。

步骤2：调用代码 #

// 选择目标文件夹
var selectedFolder = await CrossDocumentPicker.Current.PickFolderAsync();
if (selectedFolder != null)
{
    var backupFiles = new List<BackupFileInfo>();
    // 遍历文件夹内的文件
    foreach (var file in selectedFolder.Files)
    {
        backupFiles.Add(new BackupFileInfo
        {
            Name = file.FileName,
            Length = file.FileSize
        });
    }

    // 后续处理文件列表逻辑
    foreach (var file in backupFiles)
    {
        System.Diagnostics.Debug.WriteLine($">>> fi.Name = {file.Name}");
        System.Diagnostics.Debug.WriteLine($">>> fi.Length = {file.Length}");
        System.Diagnostics.Debug.WriteLine(">>> ---------------------------");
    }
}

• Android 13+如果涉及媒体文件，需要额外申请READ_MEDIA_IMAGES/READ_MEDIA_VIDEO/READ_MEDIA_AUDIO权限，但非媒体文件仍需依赖SAF。
• 不要依赖android:requestLegacyExternalStorage="true"，该配置仅对targetSdkVersion≤29的应用有效，Android 11+完全失效。
• 通过SAF获取的Uri权限可以持久化，避免用户每次打开应用都需要重新选择文件夹。

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