在Lollipop上使用Android Storage Access框架列出文件时会出现错误

Question

背景

我有一些应用程序大量使用SD卡进行文件同步。奇巧（Kitkat）上外部SD卡的损坏访问仍然是个大问题，但我正尝试使用Lollipop上针对具有此功能的用户可用的新API来解决此问题。

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

在此处查看有关此操作的更多信息：how-to-use-the-new-sd-card-access-api-presented-for-lollipop

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

问题

稍后，可能在应用程序重新启动后，可以开始文件同步。然后，我尝试在子文件夹中列出文件（请记住，我已经获得了正确的权限，并且此工作的持久性也使我可以访问所有子目录）。

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

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

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

我已经检查了DocumentFile的源代码，并且似乎有一个bug，特别是我认为不需要进一步修改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);
 }

无论使用哪种Uri调用getTreeDocumentId所找到的文档ID都将始终与根Uri id对应。这使得不可能使用提供的框架方法列出子文件夹的子级。

解决方案>>

请修复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();

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

Answer 1

潜在的错误似乎已修复。我也遇到了这个问题，并且没有任何代码更改，现在它可以与documentfile软件包的1.0.1版一起使用。