移动端Download文件夹XML文件ListView无显示 求不依赖Microsoft.Maui.Essentials的方案

你的代码核心问题是路径错误：FileSystem.AppDataDirectory指向的是应用私有存储目录，而非手机系统的公共Download文件夹，导致找不到目标XML文件，最终ListView为空。以下是不依赖Microsoft.Maui.Essentials的解决方案：

1. 获取公共Download文件夹的正确路径 #

不同移动平台的公共存储路径获取方式不同，用条件编译分别处理：

• Android平台：直接调用系统API获取公共Download目录

  #if ANDROID
  var downloadsPath = Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads).AbsolutePath;
  #endif
  

• iOS平台：iOS没有全局公共Download目录，用户下载的文件通常存放在应用的Documents目录中

  #if IOS
  var downloadsPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
  #endif
  
  

2. 添加文件访问权限 #

移动平台对外部存储访问有严格权限限制，必须配置并请求权限：

• Android：
  在AndroidManifest.xml中添加权限声明：

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  <uses-permission android:name="android.permission.READ_MEDIA_DOCUMENTS" />
  

  运行时主动请求权限：

  #if ANDROID
  var status = AndroidX.Core.Content.PermissionChecker.CheckSelfPermission(Platform.CurrentActivity, Android.Manifest.Permission.ReadExternalStorage);
  if (status != AndroidX.Core.Content.PermissionChecker.PermissionGranted)
  {
      var result = await Platform.CurrentActivity.RequestPermissionsAsync(new string[] { Android.Manifest.Permission.ReadExternalStorage });
      if (!result.ContainsValue(Android.Content.PM.Permission.Granted))
      {
          Console.WriteLine("权限被拒绝，无法访问Download文件夹");
          return;
      }
  }
  #endif
  

• iOS：
  在Info.plist中添加权限描述：

  <key>NSDocumentsFolderUsageDescription</key>
  <string>需要访问文件目录以加载XML配置文件</string>
  

3. 修改原代码适配正确逻辑 #

整合上述步骤，修改后的完整代码：

private async void LoadXmlFiles()
{
    try
    {
        string downloadsPath = string.Empty;

        // 适配不同平台路径与权限
        #if ANDROID
        // 请求存储权限
        var status = AndroidX.Core.Content.PermissionChecker.CheckSelfPermission(Platform.CurrentActivity, Android.Manifest.Permission.ReadExternalStorage);
        if (status != AndroidX.Core.Content.PermissionChecker.PermissionGranted)
        {
            var result = await Platform.CurrentActivity.RequestPermissionsAsync(new string[] { Android.Manifest.Permission.ReadExternalStorage });
            if (!result.ContainsValue(Android.Content.PM.Permission.Granted))
            {
                Console.WriteLine("权限被拒绝，无法访问Download文件夹");
                return;
            }
        }
        downloadsPath = Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads).AbsolutePath;
        #elif IOS
        downloadsPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
        #else
        downloadsPath = Path.Combine(FileSystem.AppDataDirectory, "Download");
        #endif

        // 查找目标XML文件
        var xmlFiles = Directory.GetFiles(downloadsPath, "P-COS_ScannerSettings_PCMBU4PQDL1_V1.xml");
        // 转为List确保绑定有效
        var xmlFileNames = xmlFiles.Select(f => Path.GetFileName(f)).ToList();

        // 确保在UI线程更新ListView
        MainThread.BeginInvokeOnMainThread(() =>
        {
            MyListView.ItemsSource = xmlFileNames;
        });
    }
    catch (Exception ex)
    {
        // 打印完整异常信息便于排查
        Console.WriteLine($"错误信息: {ex.Message}\n堆栈跟踪: {ex.StackTrace}");
    }
}

4. 关键注意事项 #

• 必须在UI线程更新ListView：用MainThread.BeginInvokeOnMainThread包裹赋值操作，避免跨线程绑定失效。
• 将LINQ查询结果转为List<string>：延迟加载的IEnumerable可能无法被ListView正确识别为数据源。
• 完整捕获异常：打印堆栈跟踪能帮你快速定位路径、权限等具体问题。

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