本文针对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中提取文件名。 这个方法的实现可能会因文件来源的不同而有所差异。
总结
通过移除不必要的flag并正确使用takePersistableUriPermission()方法，可以有效地解决Android应用中使用PDFView库打开PDF文件时，重启设备后出现的SecurityException问题。 确保你的代码遵循最佳实践，并进行充分的测试，以提供稳定可靠的用户体验。
