解决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权限的持久化。以下是详细步骤：

1. 移除不必要的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");

   登录后复制

2. 在onActivityResult()中调用takePersistableUriPermissions():

   

   Hour One

   AI文字到视频生成

   37

   查看详情

   当接收到文件选择器的结果时，如果请求的是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问题。 确保你的代码遵循最佳实践，并进行充分的测试，以提供稳定可靠的用户体验。

以上就是解决Android PDFView重启后无法打开PDF文件的问题的详细内容，更多请关注php中文网其它相关文章！