解决Android PDFView重启后无法打开PDF文件的问题-小浪学习网

解决Android PDFView重启后无法打开PDF文件的问题

本文针对android应用中使用PDFView库打开PDF文件时，重启手机后出现SecurityException导致文件无法打开的问题，提供了详细的解决方案。主要原因在于URI权限的持久化问题。通过移除不必要的flag，并在onActivityResult()中正确使用takePersistableUriPermissions()方法，可以确保应用在重启后仍然能够访问已授权的PDF文件。

问题分析

当你的Android应用使用ACTION_OPEN_DOCUMENT或ACTION_GET_CONTENT打开PDF文件，并将文件的URI保存在数据库中时，重启设备后可能会遇到SecurityException，错误信息通常包含Permission Denial: opening provider … requires android.permission.MANAGE_DOCUMENTS。这是因为应用在重启后，系统可能会撤销之前授予的URI权限，导致应用无法再次访问该URI指向的文件。

解决方案

解决此问题的关键在于正确处理URI权限的持久化。以下是详细步骤：

移除不必要的Flag:

在启动文件选择器的Intent中，移除FLAG_GRANT_PERSISTABLE_URI_PERMISSION。这个flag本身没有错误，但是如果不配合takePersistableUriPermissions()使用，可能会导致权限问题。

intent = new Intent(); if (Build.VERSION.SDK_INT < 19){     intent.setAction(Intent.ACTION_GET_CONTENT); } else {     intent.setAction(Intent.ACTION_OPEN_DOCUMENT);     intent.addCategory(Intent.CATEGORY_OPENABLE);     //intent.addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION); // 移除此行 }  intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION |  Intent.FLAG_GRANT_WRITE_URI_PERMISSION  ); intent.setType("application/pdf");

在onActivityResult()中调用takePersistableUriPermissions():

当接收到文件选择器的结果时，如果请求的是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) {         Uri uri;          if (resultData != null) {             uri = resultData.getData();             String name = getFileName(uri);              // 确保在获取URI之后立即调用 takePersistableUriPermissions             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {                 final int takeFlags = resultData.getFlags()                         & (Intent.FLAG_GRANT_READ_URI_PERMISSION                         | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);                 getContentResolver().takePersistableUriPermission(uri, takeFlags);             }              db.insertRowAdmins(name, uri.toString(), R.drawable.book, 23, db.getNameTableId().get(positionTab));             setNotify();         }     } }

代码解释：

resultData.getFlags()获取Intent携带的flag。
& (Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION) 使用位运算，提取出读写权限相关的flag。
getContentResolver().takePersistableUriPermission(uri, takeFlags) 调用此方法，将提取出的读写权限授予应用，并使其在设备重启后仍然有效。

完整示例代码

以下是整合了上述修改的完整代码示例：

final int KITKAT_VALUE = 1002; Intent intent; intent = new Intent(); if (Build.VERSION.SDK_INT < 19) {     intent.setAction(Intent.ACTION_GET_CONTENT); } else {     intent.setAction(Intent.ACTION_OPEN_DOCUMENT);     intent.addCategory(Intent.CATEGORY_OPENABLE); }  intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION); intent.setType("application/pdf"); try {     startActivityForResult(intent, KITKAT_VALUE); } catch (ActivityNotFoundException e) {     //alert user that file manager not working     Toast.makeText(getApplicationContext(), R.string.toast_pick_file_error, Toast.LENGTH_SHORT).show(); }   @Override protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent resultData) {     super.onActivityResult(requestCode, resultCode, resultData);     if (requestCode == 1002 && resultCode == Activity.RESULT_OK) {         Uri uri;          if (resultData != null) {             uri = resultData.getData();             String name = getFileName(uri);              // 获取持久化URI权限             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {                 final int takeFlags = resultData.getFlags()                         & (Intent.FLAG_GRANT_READ_URI_PERMISSION                         | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);                 getContentResolver().takePersistableUriPermission(uri, takeFlags);             }              db.insertRowAdmins(name, uri.toString(), R.drawable.book, 23, db.getNameTableId().get(positionTab));             setNotify();         }     } }

注意事项

权限声明: 确保你的AndroidManifest.xml文件中已经声明了必要的权限，例如READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE。虽然MANAGE_DOCUMENTS 在某些情况下可以解决问题，但通常不需要，而且属于保护权限，普通应用不应申请。
目标SDK版本: 确保你的targetSdkVersion不低于19（KitKat），因为takePersistableUriPermission()是在API Level 19引入的。
URI的有效性: 确保保存在数据库中的URI在应用重启后仍然有效。如果文件被移动或删除，URI将失效。
测试: 在真机上进行充分的测试，包括重启设备后打开PDF文件，以确保解决方案的有效性。
getFileName(Uri uri) 方法: 确保 getFileName(Uri uri) 方法能够正确地从URI中提取文件名。这个方法的实现可能会因文件来源的不同而有所差异。