本文针对Android应用中使用PDF查看器（如barteksc/AndroidPdfViewer）时，在设备重启后出现SecurityException: Permission Denial的问题，提供详细的解决方案。通过分析错误原因，并结合代码示例，指导开发者正确处理URI权限，确保应用在重启后仍能正常访问PDF文件。
在使用第三方PDF查看器库（例如 barteksc/AndroidPdfViewer）的Android应用中，一个常见的问题是在设备重启后，应用无法再访问之前选择的PDF文件，并抛出 SecurityException: Permission Denial 异常。这通常是由于URI权限在重启后失效导致的。以下将详细介绍如何解决此问题。
理解问题根源
当使用 ACTION_OPEN_DOCUMENT 或 ACTION_GET_CONTENT 等 Intent 选择文件时，系统会授予应用一个临时的URI权限，允许应用访问该文件。但是，这种权限在设备重启后会失效。如果应用需要长期访问这些文件，必须在 onActivityResult() 中调用 takePersistableUriPermission() 方法来获取持久性的URI权限。
解决方案
以下步骤展示了如何正确获取和使用持久性的URI权限：
-
移除不必要的Flag:
移除intent.addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);，这个flag实际上是不需要的，因为持久化权限的处理应该在onActivityResult()中进行。
-
在onActivityResult()中获取持久性URI权限:
在 onActivityResult() 方法中，检查请求码和结果码，确保操作成功，并且Intent中包含数据。然后，调用 takePersistableUriPermission() 方法获取持久性的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权限 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_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION): 获取Intent中包含的读写权限标志。
- getContentResolver().takePersistableUriPermission(uri, takeFlags): 调用 takePersistableUriPermission() 方法，传入URI和权限标志，请求持久性的URI权限。
-
存储URI:
将URI以字符串的形式存储在数据库中。
db.insertRowAdmins(name,uri.toString(),R.drawable.book,23, db.getNameTableId().get(positionTab));
-
加载PDF:
使用存储的URI字符串加载PDF文件。确保在加载PDF时，使用正确的URI格式。
pdfView.fromUri(Uri.parse(uriString)) .defaultPage(pageNumber) .onPageChange(this) .enableAnnotationRendering(true) .onLoad(this) .scrollHandle(new DefaultScrollHandle(this)) .spacing(10) // in dp .onPageError(this) .load();
完整代码示例
以下是一个完整的示例，展示了如何选择PDF文件、获取持久性URI权限并存储URI：
private static final int KITKAT_VALUE = 1002;
private Uri pdfUri;
private void selectPdfFile() {
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) {
Toast.makeText(getApplicationContext(), "File manager not working", Toast.LENGTH_SHORT).show();
}
}
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent resultData) {
super.onActivityResult(requestCode, resultCode, resultData);
if (requestCode == KITKAT_VALUE && resultCode == Activity.RESULT_OK) {
if (resultData != null) {
pdfUri = resultData.getData();
String name = getFileName(pdfUri);
// 获取持久性的URI权限
final int takeFlags = resultData.getFlags()
& (Intent.FLAG_GRANT_READ_URI_PERMISSION
| Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
getContentResolver().takePersistableUriPermission(pdfUri, takeFlags);
// 存储URI
savePdfUri(name, pdfUri.toString());
}
}
}
private void savePdfUri(String name, String uriString) {
// 将 URI 存储到数据库或其他持久化存储中
db.insertRowAdmins(name, uriString, R.drawable.book, 23, db.getNameTableId().get(positionTab));
setNotify();
}注意事项
- 权限声明: 确保在 AndroidManifest.xml 文件中声明了必要的权限，例如 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE（如果需要）。
- URI权限检查: 在加载PDF文件之前，检查是否已经获得了持久性的URI权限。如果没有，可能需要重新请求用户选择文件。
- 异常处理: 在加载PDF文件时，务必进行异常处理，以防止应用崩溃。
总结
通过在 onActivityResult() 方法中调用 takePersistableUriPermission() 方法，可以获取持久性的URI权限，从而解决Android应用中使用PDF查看器时，在设备重启后出现的权限问题。 遵循以上步骤，可以确保应用在重启后仍能正常访问PDF文件。
