Android 11+设备文件上传权限合规问题：替代MANAGE_EXTERNAL_STORAGE方案咨询

我的应用需要将手机下载文件夹及其他目录中的PDF文件上传至服务器，原本在Manifest中配置了如下权限：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    tools:ignore="ScopedStorage" />

功能运行正常，但上传至Google Play后，应用因“问题发现：非核心功能（使用全文件访问权限）”被持续拒绝。谷歌官方说明：依赖该权限的功能并非应用的核心功能，核心功能指应用的主要用途，缺失该功能会导致应用“无法运行”或完全不可用。现咨询：在不使用该权限的情况下，Android 11和Android 12设备实现文件上传的替代方案是什么？

以下是符合Scoped Storage规范、可通过Google Play审核的替代方案：

方案1：使用系统文件选择器（ACTION_OPEN_DOCUMENT） #

这是最合规的方案，让用户主动选择要上传的PDF，无需额外存储权限。

• 实现步骤：
  1. 启动文件选择器Intent，限定PDF类型：

     private const val REQUEST_CODE_PDF_PICKER = 1001
     
     fun openPdfPicker() {
         val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
             addCategory(Intent.CATEGORY_OPENABLE)
             type = "application/pdf"
             // 可选：允许批量选择PDF
             putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true)
         }
         startActivityForResult(intent, REQUEST_CODE_PDF_PICKER)
     }
     

  2. 处理选择结果（或使用Jetpack Activity Result API替代onActivityResult）：

     override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
         super.onActivityResult(requestCode, resultCode, data)
         if (requestCode == REQUEST_CODE_PDF_PICKER && resultCode == RESULT_OK) {
             // 单个文件处理
             data?.data?.let { uploadPdf(it) }
             // 批量文件处理
             data?.clipData?.let { clipData ->
                 for (i in 0 until clipData.itemCount) {
                     uploadPdf(clipData.getItemAt(i).uri)
                 }
             }
         }
     }
     

  3. 通过Uri读取文件并上传：

     private fun uploadPdf(uri: Uri) {
         contentResolver.openInputStream(uri)?.use { inputStream ->
             // 此处替换为你的服务器上传逻辑，示例用OkHttp
             val requestBody = RequestBody.create(
                 MediaType.parse("application/pdf"),
                 inputStream.readBytes()
             )
             val request = Request.Builder()
                 .url("你的上传接口地址")
                 .post(requestBody)
                 .build()
             // 执行网络请求...
         }
     }
     

• 优势：完全符合Google权限政策，无权限申请流程，支持所有Android 10+设备。

方案2：通过MediaStore查询已索引的PDF文件 #

如果需要自动获取系统中的PDF（如下载目录），可借助MediaStore查询，只需申请READ_EXTERNAL_STORAGE权限（Android 13+对非媒体文件仍需此权限，不会触发审核拒绝）。

• 实现步骤：
  1. 添加权限到Manifest：

     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
         android:maxSdkVersion="32" />
     

  2. 查询MediaStore中的PDF文件：

     fun queryPdfFiles() {
         val projection = arrayOf(
             MediaStore.Files.FileColumns._ID,
             MediaStore.Files.FileColumns.DISPLAY_NAME
         )
         val selection = "${MediaStore.Files.FileColumns.MIME_TYPE} = ?"
         val selectionArgs = arrayOf("application/pdf")
         val sortOrder = "${MediaStore.Files.FileColumns.DATE_MODIFIED} DESC"
     
         contentResolver.query(
             MediaStore.Files.getContentUri("external"),
             projection,
             selection,
             selectionArgs,
             sortOrder
         )?.use { cursor ->
             while (cursor.moveToNext()) {
                 val id = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Files.FileColumns._ID))
                 val pdfUri = ContentUris.withAppendedId(MediaStore.Files.getContentUri("external"), id)
                 uploadPdf(pdfUri)
             }
         }
     }
     

• 注意：Android 11+无法通过DATA字段获取真实文件路径，必须通过Uri访问；仅能获取被MediaStore索引的PDF，未被索引的文件无法查询。

方案3：使用SAF获取目录持久访问权限 #

如果需要批量处理某个目录下的所有PDF，可通过Storage Access Framework让用户授权目录访问，之后可遍历该目录下的文件。

• 实现步骤：
  1. 启动目录选择Intent：

     private const val REQUEST_CODE_DIR_PICKER = 1002
     
     fun openDirectoryPicker() {
         val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE)
         startActivityForResult(intent, REQUEST_CODE_DIR_PICKER)
     }
     

  2. 处理目录授权并持久化权限：

     override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
         super.onActivityResult(requestCode, resultCode, data)
         if (requestCode == REQUEST_CODE_DIR_PICKER && resultCode == RESULT_OK) {
             data?.data?.let { treeUri ->
                 // 持久化权限，重启应用后仍有效
                 contentResolver.takePersistableUriPermission(
                     treeUri,
                     Intent.FLAG_GRANT_READ_URI_PERMISSION
                 )
                 listPdfInDirectory(treeUri)
             }
         }
     }
     

  3. 遍历目录下的PDF文件：

     private fun listPdfInDirectory(treeUri: Uri) {
         val dirDocument = DocumentFile.fromTreeUri(this, treeUri) ?: return
         dirDocument.listFiles().forEach { file ->
             if (file.type == "application/pdf" && file.isFile) {
                 uploadPdf(file.uri)
             }
         }
     }
     

• 优势：用户仅需授权一次，即可批量处理目录内的PDF，合规性与便利性平衡。

总结建议 #

• 优先选择方案1：完全符合Google审核要求，用户操作清晰，无权限风险。
• 若需自动获取PDF，使用方案2：借助MediaStore实现，权限申请合规。
• 若需批量处理指定目录，使用方案3：通过SAF获取目录权限，兼顾效率与合规。

内容的提问来源于stack exchange，提问作者Sasi Kumar