Android PDFView权限问题解决指南

本文旨在解决Android应用中使用PDFView库（如barteksc/AndroidPdfViewer）在设备重启后出现“Permission Denial”错误的问题。通过分析错误原因，提供代码示例和步骤，帮助开发者正确处理URI权限，确保应用在重启后仍能访问PDF文件。本文重点讲解FLAG_GRANT_PERSISTABLE_URI_PERMISSION的使用和takePersistableUriPermissions()方法的重要性，并给出权限申请的建议。

深入理解权限问题

当你的Android应用使用ACTION_OPEN_DOCUMENT或ACTION_GET_CONTENT意图打开PDF文件，并使用FLAG_GRANT_PERSISTABLE_URI_PERMISSION标志时，你的应用可以获得对该URI的持久访问权限。 然而，仅仅添加这个标志是不够的。 如果没有正确地利用这些权限，应用在重启后可能会失去对文件的访问权限，导致SecurityException: Permission Denial错误。

这个错误通常发生在尝试打开存储在DownloadStorageProvider中的文件时，因为系统出于安全考虑，在应用重启后会撤销临时的URI权限。

解决方案

以下步骤可以帮助你解决这个问题：

1. 移除不必要的标志

首先，移除以下代码行：

intent.addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);

这个标志本身并不会自动赋予你持久权限。你需要配合takePersistableUriPermissions()方法来使用它。

2. 使用takePersistableUriPermissions()

在你的onActivityResult()方法中，当请求码是ACTION_OPEN_DOCUMENT时，调用takePersistableUriPermissions()方法。 该方法将持久化URI权限。

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent resultData) {
    super.onActivityResult(requestCode, resultCode, resultData);
    if (requestCode == 1002 && resultCode == Activity.RESULT_OK) {
        if (resultData != null) {
            Uri uri = resultData.getData();
            if (uri != null) {
                // Only take persistable URI permissions on ACTION_OPEN_DOCUMENT
                if (Intent.ACTION_OPEN_DOCUMENT.equals(resultData.getAction())) {
                    try {
                        getContentResolver().takePersistableUriPermission(uri,
                                Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
                    } catch (SecurityException e) {
                        // Handle the exception appropriately, e.g., log the error
                        Log.e("PermissionError", "Failed to take persistable URI permission: " + e.getMessage());
                    }
                }
                String name = getFileName(uri);
                db.insertRowAdmins(name, uri.toString(), R.drawable.book, 23, db.getNameTableId().get(positionTab));
                setNotify();
            }
        }
    }
}

解释:

• getContentResolver().takePersistableUriPermission(uri, Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);：这行代码是关键。它告诉系统你希望持久化对该URI的读写权限。

注意事项:

• 确保你的应用已经声明了READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限，并在运行时动态请求这些权限（如果你的应用targetSdkVersion >= 23）。

3. 权限声明

在你的AndroidManifest.xml文件中，确保你已经声明了必要的权限：

重要提示:

MANAGE_DOCUMENTS权限是系统权限，普通应用无法声明。 不要尝试在你的AndroidManifest.xml中声明它。

4. 检查URI访问权限

在每次访问URI之前，最好检查你是否仍然具有访问权限。你可以使用ContentResolver.getPersistedUriPermissions()来检查。

List persistedUriPermissions = getContentResolver().getPersistedUriPermissions();
for (UriPermission permission : persistedUriPermissions) {
    if (permission.getUri().equals(uri) && permission.isReadPermission() && permission.isWritePermission()) {
        // You have read and write access to this URI
        // Proceed to open the PDF file
        return;
    }
}

// You do not have persisted access to this URI. Request the user to select the file again.

5. 代码总结与示例

以下是一个完整的示例，展示了如何使用ACTION_OPEN_DOCUMENT和takePersistableUriPermissions()来打开PDF文件，并处理重启后的权限问题。

private static final int PDF_REQUEST_CODE = 1002;

private void openPdfDocument() {
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    intent.setType("application/pdf");
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

    startActivityForResult(intent, PDF_REQUEST_CODE);
}


@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if (requestCode == PDF_REQUEST_CODE && resultCode == Activity.RESULT_OK) {
        if (data != null && data.getData() != null) {
            Uri pdfUri = data.getData();

            // Take persistable URI permission
            try {
                getContentResolver().takePersistableUriPermission(pdfUri,
                        Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
            } catch (SecurityException e) {
                Log.e("PermissionError", "Failed to take persistable URI permission: " + e.getMessage());
                // Handle permission error appropriately, e.g., show an error message
                return;
            }

            // Now you can use the pdfUri to load the PDF in your PDFView
            loadPdf(pdfUri);
        }
    }
}

private void loadPdf(Uri pdfUri) {
    // Load the PDF using your PDFView library (e.g., AndroidPdfViewer)
    // Example:
    // pdfView.fromUri(pdfUri).load();
    // Replace pdfView with your actual PDFView instance.
}

总结

通过移除不必要的标志，使用takePersistableUriPermissions()方法，并在每次访问URI之前检查权限，你可以解决Android应用中使用PDFView库在设备重启后出现的“Permission Denial”错误。 记住，正确处理URI权限对于提供流畅的用户体验至关重要。 确保你的代码健壮，并能优雅地处理权限相关的错误。