如何使用为Android 5.0（Lollipop）提供的新SD卡访问API？

#1 楼

很多好问题，让我们深入探讨。:)

如何使用它？

这是与KitKat中的存储访问框架进行交互的出色教程：

https://developer.android.com/guide/topics/providers/document-provider.html#client

与Lollipop中的新API交互非常相似。要提示用户选择目录树，可以启动这样的意图：

    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
    startActivityForResult(intent, 42);

然后在onActivityResult（）中，可以传递用户选择的Uri到新的DocumentFile帮助器类。这是一个简单的示例，列出了所选目录中的文件，然后创建了一个新文件：

public void onActivityResult(int requestCode, int resultCode, Intent resultData) {
    if (resultCode == RESULT_OK) {
        Uri treeUri = resultData.getData();
        DocumentFile pickedDir = DocumentFile.fromTreeUri(this, treeUri);

        // List all existing files inside picked directory
        for (DocumentFile file : pickedDir.listFiles()) {
            Log.d(TAG, "Found file " + file.getName() + " with size " + file.length());
        }

        // Create a new file and write into it
        DocumentFile newFile = pickedDir.createFile("text/plain", "My Novel");
        OutputStream out = getContentResolver().openOutputStream(newFile.getUri());
        out.write("A long time ago...".getBytes());
        out.close();
    }
}

DocumentFile.getUri()返回的Uri足够灵活，可以与不同的文件一起使用平台API。例如，可以使用Intent.setData()和Intent.FLAG_GRANT_READ_URI_PERMISSION共享它。

如果要从本机代码访问该Uri，可以调用ContentResolver.openFileDescriptor()，然后使用ParcelFileDescriptor.getFd()或detachFd()获得传统的POSIX文件描述符整数。

如何检查是否可以访问文件/文件夹？

默认情况下，通过Storage Access Frameworks意图返回的Uris在重新启动后不会持久存在。该平台“提供”持久权限的能力，但是如果需要，您仍然需要“获得”该权限。在上面的示例中，您将调用：

    getContentResolver().takePersistableUriPermission(treeUri,
            Intent.FLAG_GRANT_READ_URI_PERMISSION |
            Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

您总是可以找出持久性授予您的应用程序通过ContentResolver.getPersistedUriPermissions() API可以访问的内容。如果您不再需要访问保留的Uri，则可以使用ContentResolver.releasePersistableUriPermission()释放它。

可以在KitKat上使用吗？

不，我们无法追溯添加新功能到该平台的旧版本。

我可以查看哪些应用程序可以访问文件/文件夹吗？

当前没有显示此内容的用户界面，但您可以在中找到详细信息adb shell dumpsys activity providers输出的“授予的Uri权限”部分。

如果在同一设备上为多个用户安装一个应用程序，会发生什么情况？

Uri权限授予是按用户隔离的，就像所有其他多用户平台功能一样。也就是说，在两个不同用户下运行的同一应用程序没有重叠或共享的Uri权限授予。

可以撤消权限吗？

支持DocumentProvider可以随时撤消权限时间，例如删除基于云的文档时。发现这些已撤销权限的最常见方法是，当它们从上述ContentResolver.getPersistedUriPermissions()中消失时。 >是否要在选定的文件夹上递归请求许可权？是允许多选吗？

是的，自KitKat支持多选，您可以通过在启动ACTION_OPEN_DOCUMENT_TREE目的时设置EXTRA_ALLOW_MULTIPLE来允许选择。您可以使用ACTION_OPEN_DOCUMENT或Intent.setType()缩小可以选择的文件类型：

http://developer.android.com/reference/android/content/Intent.html#ACTION_OPEN_DOCUMENT

模拟器上是否有办法尝试新的API？

是的，主要的共享存储设备应该出现在选择器中，即使在模拟器上也是如此。如果您的应用仅使用Storage Access Framework来访问共享存储，则根本不再需要EXTRA_MIME_TYPES权限，可以删除它们或使用READ/WRITE_EXTERNAL_STORAGE功能仅在较旧的平台版本上请求它们。

用户用另一张SD卡替换SD卡会发生什么情况？

当涉及到物理介质时，基础介质的UUID（例如FAT序列号）总是被刻录到返回的Uri中。即使用户在多个插槽之间交换介质，系统也会使用它将您连接到用户最初选择的介质。

如果用户交换第二张卡，则需要提示访问新卡。由于系统会根据每个UUID记住赠款，因此如果用户稍后重新插入原始卡，您将继续拥有先前授予的访问权。

http://en.wikipedia.org / wiki / Volume_serial_number

#2 楼

在下面链接的我在Github的Android项目中，您可以找到可以在Android 5中的extSdCard上进行写入的工作代码。它假定用户可以访问整个SD卡，然后您可以在该卡上的任何位置进行写入。 （如果您只希望访问单个文件，则事情会变得更加容易。）

主要代码片段

触发存储访问框架：

@TargetApi(Build.VERSION_CODES.LOLLIPOP)
private void triggerStorageAccessFramework() {
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
    startActivityForResult(intent, REQUEST_CODE_STORAGE_ACCESS);
}

处理来自Storage Access Framework的响应：

@TargetApi(Build.VERSION_CODES.LOLLIPOP)
@Override
public final void onActivityResult(final int requestCode, final int resultCode, final Intent resultData) {
    if (requestCode == SettingsFragment.REQUEST_CODE_STORAGE_ACCESS) {
        Uri treeUri = null;
        if (resultCode == Activity.RESULT_OK) {
            // Get Uri from Storage Access Framework.
            treeUri = resultData.getData();

            // Persist URI in shared preference so that you can use it later.
            // Use your own framework here instead of PreferenceUtil.
            PreferenceUtil.setSharedPreferenceUri(R.string.key_internal_uri_extsdcard, treeUri);

            // Persist access permissions.
            final int takeFlags = resultData.getFlags()
                & (Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
            getActivity().getContentResolver().takePersistableUriPermission(treeUri, takeFlags);
        }
    }
}

通过Storage Access Framework获取文件的outputStream（利用存储的URL（假设这是外部SD卡的根文件夹的URL）。

DocumentFile targetDocument = getDocumentFile(file, false);
OutputStream outStream = Application.getAppContext().
    getContentResolver().openOutputStream(targetDocument.getUri());

它使用以下帮助方法： />

public static DocumentFile getDocumentFile(final File file, final boolean isDirectory) {
    String baseFolder = getExtSdCardFolder(file);

    if (baseFolder == null) {
        return null;
    }

    String relativePath = null;
    try {
        String fullPath = file.getCanonicalPath();
        relativePath = fullPath.substring(baseFolder.length() + 1);
    }
    catch (IOException e) {
        return null;
    }

    Uri treeUri = PreferenceUtil.getSharedPreferenceUri(R.string.key_internal_uri_extsdcard);

    if (treeUri == null) {
        return null;
    }

    // start with root of SD card and then parse through document tree.
    DocumentFile document = DocumentFile.fromTreeUri(Application.getAppContext(), treeUri);

    String[] parts = relativePath.split("\/");
    for (int i = 0; i < parts.length; i++) {
        DocumentFile nextDocument = document.findFile(parts[i]);

        if (nextDocument == null) {
            if ((i < parts.length - 1) || isDirectory) {
                nextDocument = document.createDirectory(parts[i]);
            }
            else {
                nextDocument = document.createFile("image", parts[i]);
            }
        }
        document = nextDocument;
    }

    return document;
}

public static String getExtSdCardFolder(final File file) {
    String[] extSdPaths = getExtSdCardPaths();
    try {
        for (int i = 0; i < extSdPaths.length; i++) {
            if (file.getCanonicalPath().startsWith(extSdPaths[i])) {
                return extSdPaths[i];
            }
        }
    }
    catch (IOException e) {
        return null;
    }
    return null;
}

/**
 * Get a list of external SD card paths. (Kitkat or higher.)
 *
 * @return A list of external SD card paths.
 */
@TargetApi(Build.VERSION_CODES.KITKAT)
private static String[] getExtSdCardPaths() {
    List<String> paths = new ArrayList<>();
    for (File file : Application.getAppContext().getExternalFilesDirs("external")) {
        if (file != null && !file.equals(Application.getAppContext().getExternalFilesDir("external"))) {
            int index = file.getAbsolutePath().lastIndexOf("/Android/data");
            if (index < 0) {
                Log.w(Application.TAG, "Unexpected external file dir: " + file.getAbsolutePath());
            }
            else {
                String path = file.getAbsolutePath().substring(0, index);
                try {
                    path = new File(path).getCanonicalPath();
                }
                catch (IOException e) {
                    // Keep non-canonical path.
                }
                paths.add(path);
            }
        }
    }
    return paths.toArray(new String[paths.size()]);
}

 /**
 * Retrieve the application context.
 *
 * @return The (statically stored) application context
 */
public static Context getAppContext() {
    return Application.mApplication.getApplicationContext();
}

参考完整代码

https://github.com/jeisfeld/Augendiagnose/blob/master/AugendiagnoseIdea/augendiagnoseLib/src/main/java/ de / jeisfeld / augendiagnoselib / fragments / SettingsFragment.java＃L521

和

https://github.com/jeisfeld/Augendiagnose/blob/master/AugendiagnoseIdea/augendiagnoseLib/ src / main / java / de / jeisfeld / augendiagnoselib / util / imagefile / FileUtil.java

#3 楼

这只是一个补充性的答案。

创建新文件后，您可能需要将其位置保存到数据库中，明天再阅读。您可以使用以下方法再次读取并检索它：

/**
 * Get {@link DocumentFile} object from SD card.
 * @param directory SD card ID followed by directory name, for example {@code 6881-2249:Download/Archive},
 *                 where ID for SD card is {@code 6881-2249}
 * @param fileName for example {@code intel_haxm.zip}
 * @return <code>null</code> if does not exist
 */
public static DocumentFile getExternalFile(Context context, String directory, String fileName){
    Uri uri = Uri.parse("content://com.android.externalstorage.documents/tree/" + directory);
    DocumentFile parent = DocumentFile.fromTreeUri(context, uri);
    return parent != null ? parent.findFile(fileName) : null;
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == SettingsFragment.REQUEST_CODE_STORAGE_ACCESS && resultCode == RESULT_OK) {
        int takeFlags = Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION;
        getContentResolver().takePersistableUriPermission(data.getData(), takeFlags);
        String sdcard = data.getDataString().replace("content://com.android.externalstorage.documents/tree/", "");
        try {
            sdcard = URLDecoder.decode(sdcard, "ISO-8859-1");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        // for example, sdcardId results "6312-2234"
        String sdcardId = sdcard.substring(0, sdcard.indexOf(':'));
        // save to preferences if you want to use it later
        SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(this);
        preferences.edit().putString("sdcard", sdcardId).apply();
    }
}