8

我正在尝试编写一个自定义DocumentsProvider,允许其他应用程序对其提供的 Uris 获取持久权限

我有一个DocumentsProvider我声明AndroidManufest.xml如下

<provider
   android:name="com.cgogolin.myapp.MyContentProvider"
   android:authorities="com.cgogolin.myapp.MyContentProvider"
   android:grantUriPermissions="true"
   android:exported="true"
   android:permission="android.permission.MANAGE_DOCUMENTS"
   android:enabled="@bool/atLeastKitKat">
  <intent-filter>
    <action android:name="android.content.action.DOCUMENTS_PROVIDER" />
  </intent-filter>
</provider>

我的应用MANAGE_DOCUMENTS设置了权限

<uses-permission android:name="android.permission.MANAGE_DOCUMENTS" />

(显然这不是必需的,但添加/删除它也无关紧要)。ACTION_OPEN_DOCUMENT然后,当我打开选择器 UI时,我可以看到我的提供者

Intent openDocumentIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
openDocumentIntent.addCategory(Intent.CATEGORY_OPENABLE);
openDocumentIntent.setType("application/pdf");
openDocumentIntent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION|Intent.FLAG_GRANT_WRITE_URI_PERMISSION|Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
startActivityForResult(openDocumentIntent, EDIT_REQUEST);

并且,在从我的提供者那里选择一个文件后,在onActivityResult()我的应用程序的方法中,我可以成功地打开我DocumentsProvider通过UriI get from提供的文件intent.getData()

但是,尝试使用

getContentResolver().takePersistableUriPermission(uri, Intent.FLAG_GRANT_READ_URI_PERMISSION);

或者

getContentResolver().takePersistableUriPermission(uri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

总是失败并出现异常,例如

No permission grant found for UID 10210 and Uri content://com.cgogolin.myapp.MyContentProvider/document/tshjhczf.pdf

如果我从谷歌驱动器或选择器 UI 中的下载提供程序中选择一个文件,以这种方式获取权限。所以我认为问题出在我的提供者身上。

尽管我指定了,为什么没有创建权限授予android:grantUriPermissions="true"

如何说服 Android 为我创建这样的权限授予?

毕竟我不认为我可以自己做,因为我不知道UID打开选择器 UI 的过程,或者至少不知道我知道如何。

4

2 回答 2

3

编辑:

我之前的回答不好。出于安全原因,您应该使用“android.permission.MANAGE_DOCUMENTS”。
只有系统 UI 选择器才能列出您的文档。

但是您在打开文档的应用程序清单中不需要此权限。 实际上你不应该能够获得这个权限,因为它是系统权限。

我刚刚对其进行了测试并调用了 takePersistableUriPermission 表单 onActivityResult 是成功的。

我将 DocumentProvider 与模拟数据(一个根,3 个 txt 文档)一起使用。
如果它仍然对您不起作用,则您的文档提供者可能存在问题。

编辑2:

示例代码

package com.example.test;

import android.database.Cursor;
import android.database.MatrixCursor;
import android.os.CancellationSignal;
import android.os.ParcelFileDescriptor;
import android.provider.DocumentsProvider;

import java.io.FileNotFoundException;

public class MyContentProvider extends DocumentsProvider {

    private final static String[] rootColumns = new String[]{
            "_id", "root_id", "title", "icon"
    };
    private final static String[] docColumns = new String[]{
            "_id", "document_id", "_display_name", "mime_type", "icon"
    };

    MatrixCursor matrixCursor;
    MatrixCursor matrixRootCursor;

    @Override
    public boolean onCreate() {

        matrixRootCursor = new MatrixCursor(rootColumns);
        matrixRootCursor.addRow(new Object[]{1, 1, "TEST", R.mipmap.ic_launcher});

        matrixCursor = new MatrixCursor(docColumns);
        matrixCursor.addRow(new Object[]{1, 1, "a.txt", "text/plain", R.mipmap.ic_launcher});
        matrixCursor.addRow(new Object[]{2, 2, "b.txt", "text/plain", R.mipmap.ic_launcher});
        matrixCursor.addRow(new Object[]{3, 3, "c.txt", "text/plain", R.mipmap.ic_launcher});

        return true;
    }

    @Override
    public Cursor queryRoots(String[] projection) throws FileNotFoundException {
        return matrixRootCursor;
    }

    @Override
    public Cursor queryDocument(String documentId, String[] projection)
            throws FileNotFoundException {

        return matrixCursor;
    }

    @Override
    public Cursor queryChildDocuments(String parentDocumentId, String[] projection,
                                      String sortOrder)
            throws FileNotFoundException {

        return matrixCursor;
    }

    @Override
    public ParcelFileDescriptor openDocument(String documentId, String mode,
                                             CancellationSignal signal)
            throws FileNotFoundException {

        int id;
        try {
            id = Integer.valueOf(documentId);
        } catch (NumberFormatException e) {
            throw new FileNotFoundException("Incorrect document ID " + documentId);
        }

        String filename = "/sdcard/";

        switch (id) {
            case 1:
                filename += "a.txt";
                break;
            case 2:
                filename += "b.txt";
                break;
            case 3:
                filename += "c.txt";
                break;
            default:
                throw new FileNotFoundException("Unknown document ID " + documentId);
        }

        return ParcelFileDescriptor.open(new File(filename),
                ParcelFileDescriptor.MODE_READ_WRITE);
    }
}

注意:
您可以使用DocumentsContract.DocumentDocumentsContract.Root中的常量。
我不确定是否需要“_id”。

编辑3:

更新了从 /sdcard 打开文档的示例代码。
添加了读/写外部存储权限。

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest
    package="com.example.test"
    xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

    <application
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name">

        <provider
            android:name="com.example.test.MyContentProvider"
            android:authorities="com.example.test.document"
            android:enabled="true"
            android:exported="@bool/atLeastKitKat"
            android:grantUriPermissions="true"
            android:permission="android.permission.MANAGE_DOCUMENTS">
            <intent-filter>
                <action android:name="android.content.action.DOCUMENTS_PROVIDER"/>
            </intent-filter>
        </provider>
    </application>

</manifest>

客户端应用

具有空活动的新项目,未添加任何权限

打开文档

Intent openDocumentIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
openDocumentIntent.addCategory(Intent.CATEGORY_OPENABLE);
openDocumentIntent.setType("text/plain");
openDocumentIntent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION
                    | Intent.FLAG_GRANT_WRITE_URI_PERMISSION
                    | Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
startActivityForResult(openDocumentIntent, 1);

onActivityResult

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    switch (requestCode) {
        case 1: // TODO: Use constant
            if (resultCode == RESULT_OK) {
                if (data == null) return; // TODO: Show error
                Uri uri = data.getData();
                if (uri == null) return; // TODO: Show error
                getContentResolver().takePersistableUriPermission(uri,
                        Intent.FLAG_GRANT_READ_URI_PERMISSION);

                InputStream is = null;
                try {
                    is = getContentResolver().openInputStream(uri);

                    // Just for quick sample (I know what I will read)
                    byte[] buffer = new byte[1024];
                    int read = is.read(buffer);
                    String text = new String(buffer, 0, read);

                    ((TextView) findViewById(R.id.text)).setText(text);
                } catch (IOException e) {
                    e.printStackTrace();
                } finally {
                    if (is != null) try {
                        is.close();
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
            }
            break;
    }
}
于 2016-01-07T01:07:50.257 回答
1

使用 SAF 时,API 19-25 上的预期行为SecurityException是为您自己的 URI 抛出a DocumentProvider

这在 API 26 及更高版本上发生了变化,现在允许 URI 的持久 URI 权限,即使来自您自己的进程(没有官方文档,但通过测试观察)

但是,即使您有一段SecurityException时间尝试获取可持久的 URI 权限,您仍然可以始终访问从您自己的DocumentsProvider.

因此,SecurityException当内容权限来自您自己的流程时,捕捉并忽略它是一个好主意。

注意:如果您的应用程序包含 DocumentsProvider 并且还保留从 ACTION_OPEN_DOCUMENT、ACTION_OPEN_DOCUMENT_TREE 或 ACTION_CREATE_DOCUMENT 返回的 URI,请注意,您将无法通过 takePersistableUriPermission() 保留对您自己的 URI 的访问——尽管它因 SecurityException 而失败,您'将始终可以从您自己的应用程序访问 URI。如果您想在 API 23+ 设备上隐藏您自己的 DocumentsProvider(s) 以执行任何这些操作,则可以将布尔值 EXTRA_EXCLUDE_SELF 添加到您的 Intent 中。

这是来自官方 Android 开发人员博客的注释,证实了这种行为 - https://medium.com/androiddevelopers/building-a-documentsprovider-f7f2fb38e86a

于 2021-06-12T04:17:39.180 回答