本文旨在解决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()来检查。
ListpersistedUriPermissions = 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权限对于提供流畅的用户体验至关重要。 确保你的代码健壮，并能优雅地处理权限相关的错误。
