本文旨在解决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文件中,确保你已经声明了必要的权限:
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
重要提示:
MANAGE_DOCUMENTS权限是系统权限,普通应用无法声明。 不要尝试在你的AndroidManifest.xml中声明它。
4. 检查URI访问权限
在每次访问URI之前,最好检查你是否仍然具有访问权限。你可以使用ContentResolver.getPersistedUriPermissions()来检查。
List<UriPermission> 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权限对于提供流畅的用户体验至关重要。 确保你的代码健壮,并能优雅地处理权限相关的错误。