背景
Google(可悲地)计划破坏存储权限,这样应用程序将无法使用标准的文件API(和文件路径)访问文件系统。很多人反对此举,因为它改变了应用程序访问存储的方式,而且这是一种受限制和有限的API。
因此,如果我们希望处理各种存储卷并访问其中所有文件,我们将需要在未来某个Android版本上完全使用SAF(存储访问框架)(在Android Q上,我们至少可以暂时使用标志来使用普通存储权限)。
例如,假设你想制作一个文件管理器并显示设备的所有存储卷,以展示用户可以授权访问的内容,并且如果你已经可以访问每个存储卷,你只需要进入即可。这似乎是一件非常合理的事情,但我找不到方法去做到这一点。
问题
从API 24开始(这里),我们终于有了列出所有存储卷的能力,可以像这样:
val storageManager = getSystemService(Context.STORAGE_SERVICE) as StorageManager
val storageVolumes = storageManager.storageVolumes
而且,我们现在首次可以使用意图(Intent)请求访问存储卷(在这里)。因此,如果我们想要请求用户授权访问主存储卷(实际上只会从那里开始,并不会真正询问任何内容),我们可以使用以下代码:
startActivityForResult(storageManager.primaryStorageVolume.createOpenDocumentTreeIntent(), REQUEST_CODE__DIRECTORTY_PERMISSION)
我们可以使用 startActivityForResult(Intent(Intent.ACTION_OPEN_DOCUMENT_TREE), REQUEST_CODE__DIRECTORTY_PERMISSION)
来让用户选择目录,但这样不一定会得到正确的结果。
最终获取用户所选择目录的代码如下:
@TargetApi(Build.VERSION_CODES.KITKAT)
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == REQUEST_CODE__DIRECTORTY_PERMISSION && resultCode == Activity.RESULT_OK && data != null) {
val treeUri = data.data ?: return
contentResolver.takePersistableUriPermission(treeUri, Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION)
val pickedDir = DocumentFile.fromTreeUri(this, treeUri)
...
目前,我们可以在各种存储卷上请求权限...
但是,如果您想知道哪些卷已获得许可,哪些没有,则会出现问题。
我找到的信息
Google有一个关于“作用域目录访问”的视频(这里),其中他们专门谈论StorageVolume类。他们甚至提供了有关监听StorageVolume挂载事件的信息,但他们没有告诉我们如何识别那些我们已经访问过的存储卷。
StorageVolume类的唯一ID是uuid,但不能保证其返回任何内容。实际上,在各种情况下都会返回null。例如,主要存储的情况。
当使用
createOpenDocumentTreeIntent
函数时,我注意到其中隐藏了一个Uri,可能告诉我们从哪里开始。它在extras中,在一个名为“android.provider.extra.INITIAL_URI”的键中。例如,在主要存储上检查其值时,我得到了这个:content://com.android.externalstorage.documents/root/primary
当我查看onActivityResult中返回的Uri时,我得到了与#2有点相似但对于我展示的
treeUri
变量不同的东西:content://com.android.externalstorage.documents/tree/primary%3A
为了获得到目前为止访问的列表,您可以使用此内容:
val persistedUriPermissions = contentResolver.persistedUriPermissions
这将返回一个UriPermission列表,每个都有一个Uri。不幸的是,当我使用它时,我得到的与#3相同,我无法将其与StorageVolume获取的内容进行比较:
content://com.android.externalstorage.documents/tree/primary%3A
所以你可以看到,我找不到存储卷列表和用户授权之间任何形式的映射。
我甚至无法知道用户是否选择了存储卷,因为createOpenDocumentTreeIntent
函数的功能只是将用户发送到StorageVolume,但仍然可能选择文件夹。
我唯一拥有的是一些绕过方法函数的代码块,我在其他问题中找到了它们,但我不认为它们可靠,特别是现在我们实际上无法访问File API和文件路径。
我在这里写下了它们,以防你认为它们有用:
@TargetApi(VERSION_CODES.LOLLIPOP)
private static String getVolumeIdFromTreeUri(final Uri treeUri) {
final String docId = DocumentsContract.getTreeDocumentId(treeUri);
final int end = docId.indexOf(':');
String result = end == -1 ? null : docId.substring(0, end);
return result;
}
private static String getDocumentPathFromTreeUri(final Uri treeUri) {
final String docId = DocumentsContract.getTreeDocumentId(treeUri);
//TODO avoid using spliting of a string (because it uses extra strings creation)
final String[] split = docId.split(":");
if ((split.length >= 2) && (split[1] != null))
return split[1];
else
return File.separator;
}
public static String getFullPathOfDocumentFile(Context context, DocumentFile documentFile) {
String volumePath = getVolumePath(context, getVolumeIdFromTreeUri(documentFile.getUri()));
if (volumePath == null)
return null;
DocumentFile parent = documentFile.getParentFile();
if (parent == null)
return volumePath;
final LinkedList<String> fileHierarchy = new LinkedList<>();
while (true) {
fileHierarchy.add(0, documentFile.getName());
documentFile = parent;
parent = documentFile.getParentFile();
if (parent == null)
break;
}
final StringBuilder sb = new StringBuilder(volumePath).append(File.separator);
for (String fileName : fileHierarchy)
sb.append(fileName).append(File.separator);
return sb.toString();
}
/**
* Get the full path of a document from its tree URI.
*
* @param treeUri The tree RI.
* @return The path (without trailing file separator).
*/
public static String getFullPathFromTreeUri(Context context, final Uri treeUri) {
if (treeUri == null)
return null;
String volumePath = getVolumePath(context, getVolumeIdFromTreeUri(treeUri));
if (volumePath == null)
return File.separator;
if (volumePath.endsWith(File.separator))
volumePath = volumePath.substring(0, volumePath.length() - 1);
String documentPath = getDocumentPathFromTreeUri(treeUri);
if (documentPath.endsWith(File.separator))
documentPath = documentPath.substring(0, documentPath.length() - 1);
if (documentPath.length() > 0)
if (documentPath.startsWith(File.separator))
return volumePath + documentPath;
else return volumePath + File.separator + documentPath;
return volumePath;
}
/**
* Get the path of a certain volume.
*
* @param volumeId The volume id.
* @return The path.
*/
private static String getVolumePath(Context context, final String volumeId) {
if (VERSION.SDK_INT < VERSION_CODES.LOLLIPOP)
return null;
try {
final StorageManager storageManager = (StorageManager) context.getSystemService(Context.STORAGE_SERVICE);
if (VERSION.SDK_INT >= VERSION_CODES.N) {
final Class<?> storageVolumeClazz = StorageVolume.class;
final Method getPath = storageVolumeClazz.getMethod("getPath");
final List<StorageVolume> storageVolumes = storageManager.getStorageVolumes();
for (final StorageVolume storageVolume : storageVolumes) {
final String uuid = storageVolume.getUuid();
final boolean primary = storageVolume.isPrimary();
// primary volume?
if (primary && PRIMARY_VOLUME_NAME.equals(volumeId)) {
return (String) getPath.invoke(storageVolume);
}
// other volumes?
if (uuid != null && uuid.equals(volumeId))
return (String) getPath.invoke(storageVolume);
}
return null;
}
final Class<?> storageVolumeClazz = Class.forName("android.os.storage.StorageVolume");
final Method getVolumeList = storageManager.getClass().getMethod("getVolumeList");
final Method getUuid = storageVolumeClazz.getMethod("getUuid");
//noinspection JavaReflectionMemberAccess
final Method getPath = storageVolumeClazz.getMethod("getPath");
final Method isPrimary = storageVolumeClazz.getMethod("isPrimary");
final Object result = getVolumeList.invoke(storageManager);
final int length = Array.getLength(result);
for (int i = 0; i < length; i++) {
final Object storageVolumeElement = Array.get(result, i);
final String uuid = (String) getUuid.invoke(storageVolumeElement);
final Boolean primary = (Boolean) isPrimary.invoke(storageVolumeElement);
// primary volume?
if (primary && PRIMARY_VOLUME_NAME.equals(volumeId)) {
return (String) getPath.invoke(storageVolumeElement);
}
// other volumes?
if (uuid != null && uuid.equals(volumeId))
return (String) getPath.invoke(storageVolumeElement);
}
// not found.
return null;
} catch (Exception ex) {
return null;
}
}
问题
如何在存储卷列表和授权的UriPermission列表之间进行映射?
换句话说,给定一个存储卷列表,我如何知道哪些存储卷我可以访问,哪些我不能访问,并且如果我有权限访问,则如何打开并查看其内容?