解决Android PDFView重启后权限问题:一份详细指南

解决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文件中,确保你已经声明了必要的权限:

<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权限对于提供流畅的用户体验至关重要。 确保你的代码健壮,并能优雅地处理权限相关的错误。

© 版权声明
THE END
喜欢就支持一下吧
点赞5 分享