在 Lollipop 上使用 Android 存储访问框架列出文件时出现错误

背景

我有一些应用程序大量使用 SD 卡进行文件同步。 Kitkat 上的外部 SD 卡访问损坏仍然是一个大问题，但我正在尝试使用 Lollipop 上提供的新 API 为拥有此问题的用户解决此问题。

我成功请求并保留了对 SD 卡的权限，并且我可以列出从授予权限活动返回的根 Uri 中的文件。

请在此处查看有关如何完成此操作的更多信息：如何使用棒棒糖的新 SD 卡访问 api https://stackoverflow.com/questions/26744842/how-to-use-the-new-sd-card-access-api-presented-for-lollipop

然后，用户可以选择任何文件夹/子文件夹进行同步，我将文件夹文档 Uri 作为字符串保留在数据库中。

Problem

稍后，可能在应用程序重新启动后，可以启动文件同步。然后，我尝试列出子文件夹中的文件（请记住，我已授予正确的权限，并且该权限有效，并且还允许我访问所有子文件夹）。

然后，我从存储的字符串创建一个新的 DocumentFile 实例并尝试列出文件：

  DocumentFile dir = DocumentFile.fromTreeUri(ctx, Uri.parse(storedUri));
  dir.listFiles();

问题是 listFiles 总是返回授予的根 Uri 的子级，而不返回我给 DocumentFile.fromTreeUri 方法的实际 Uri 的子级。

我已经检查了源代码文档文件 http://grepcode.com/file/repository.grepcode.com/java/ext/com.google.android/android/5.0.0_r1/android/support/v4/provider/DocumentFile.java那里似乎有一个错误，特别是我认为不需要进一步修改 Uri：

public static DocumentFile fromTreeUri(Context context, Uri treeUri) {
  final int version = Build.VERSION.SDK_INT;
  if (version >= 21) {
    return new TreeDocumentFile(null, context,
      DocumentsContractApi21.prepareTreeUri(treeUri));
  } else {
  return null;
}

如果我们查看 DocumentsContractApi21.prepareTreeUri 的源代码，我们会看到重建了 Uri：

 public static Uri prepareTreeUri(Uri treeUri) {
   return DocumentsContract.buildDocumentUriUsingTree(treeUri,
     DocumentsContract.getTreeDocumentId(treeUri));
 }

以及它调用的方法：

 public static Uri buildDocumentUriUsingTree(Uri treeUri, String documentId) {
   return new Uri.Builder().scheme(ContentResolver.SCHEME_CONTENT)
                 .authority(treeUri.getAuthority()).appendPath(PATH_TREE)
                 .appendPath(getTreeDocumentId(treeUri)).appendPath(PATH_DOCUMENT)
                 .appendPath(documentId).build();
 }

 public static String getTreeDocumentId(Uri documentUri) {
   final List<String> paths = documentUri.getPathSegments();
   if (paths.size() >= 2 && PATH_TREE.equals(paths.get(0))) {
     return paths.get(1);
   }
   throw new IllegalArgumentException("Invalid URI: " + documentUri);
 }

通过 getTreeDocumentId 找到的文档 Id 将始终对应于根 Uri id，无论使用什么 Uri 调用方法。这使得无法使用提供的框架方法列出子文件夹的子文件夹。

Solution

请修复 fromTreeUri 方法，使其不总是使用根文档 Uri id。

执行以下丑陋的黑客解决了这个问题，我真的不想这样做。

  Class<?> c = Class.forName("android.support.v4.provider.TreeDocumentFile");
  Constructor<?> constructor = c.getDeclaredConstructor(DocumentFile.class, Context.class, Uri.class);
  constructor.setAccessible(true);

  DocumenFile dir = (DocumentFile) constructor.newInstance(null, mCtx, treeUri);
  dir.listFiles();

潜在的错误似乎已得到修复。我也遇到了这个问题，无需任何代码更改，它现在可以在 1.0.1 版本中使用documentfile包裹。

dependencies {
    ...
    implementation 'androidx.documentfile:documentfile:1.0.1'
    ...
}