Android API33下XML文件导出权限与存储问题咨询

针对你遇到的API33上导出XML文件权限及写入异常问题，结合Scoped Storage规则，逐一解答你的疑问：

1. Jerry提到的“第二个文件夹”能否被原生文件浏览器访问？ #

可以直接访问。这里的“第二个文件夹”指的是应用在公共存储目录（如Download）下创建的专属子文件夹，属于Scoped Storage允许的公共可见区域，无需额外授权，用户能通过原生文件浏览器直接找到导出的文件，不会出现应用外无法访问的情况。

2. 如何用Kotlin获取该文件夹？ #

如果是在Download目录下创建应用专属子文件夹，可通过以下代码获取（API24+兼容）：

import android.os.Environment
import java.io.File

// 获取Download目录下的应用专属导出文件夹
fun getAppExportDir(): File? {
    val downloadPublicDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)
    val appExportDir = File(downloadPublicDir, "你的应用导出文件夹名称")
    return if (appExportDir.apply { if (!exists()) mkdirs() }.exists()) {
        appExportDir
    } else null
}

注意：API30+下，直接通过File对象写入该文件夹需要MANAGE_EXTERNAL_STORAGE权限（不推荐，因为需要用户手动授权特殊权限），更合规的方式是用MediaStore写入（见问题4的方案）。

3. 该“第二个文件夹”特性的兼容性？ #

从API24到API33均兼容，但不同版本的权限规则有差异：

• API24-28：可直接通过File对象读写，需要申请WRITE_EXTERNAL_STORAGE权限；
• API29-30：默认启用Scoped Storage，直接File写入公共目录会受限，推荐用MediaStore或SAF；
• API31+：WRITE_EXTERNAL_STORAGE权限完全失效，必须用MediaStore或SAF方式写入公共存储。

4. API33下的正确导出方案 #

由于API33中WRITE_EXTERNAL_STORAGE已无效，推荐两种合规方案：

方案一：通过MediaStore写入公共Download目录 #

无需申请任何存储权限，直接将文件写入Download目录的应用专属子文件夹，代码示例：

import android.content.ContentResolver
import android.content.Context
import android.os.Environment
import android.provider.MediaStore
import java.io.OutputStream

fun exportXmlToDownload(context: Context, xmlContent: String, fileName: String) {
    val contentValues = ContentValues().apply {
        put(MediaStore.MediaColumns.DISPLAY_NAME, fileName)
        put(MediaStore.MediaColumns.MIME_TYPE, "application/xml")
        // 指定存储路径为Download下的应用专属文件夹
        put(MediaStore.MediaColumns.RELATIVE_PATH, "${Environment.DIRECTORY_DOWNLOADS}/你的应用导出文件夹名称")
    }

    val contentUri = MediaStore.Downloads.EXTERNAL_CONTENT_URI
    val resolver: ContentResolver = context.contentResolver

    resolver.insert(contentUri, contentValues)?.let { uri ->
        resolver.openOutputStream(uri)?.use { outputStream: OutputStream ->
            outputStream.write(xmlContent.toByteArray())
        }
    }
}

文件会自动出现在Download/你的应用导出文件夹名称下，原生文件浏览器可直接访问。

方案二：使用存储访问框架（SAF）让用户选择保存位置 #

完全遵循Scoped Storage设计，让用户自主选择文件保存路径，无需权限，代码示例：

import android.app.Activity
import android.content.Intent
import android.provider.DocumentsContract
import android.provider.MediaStore

private const val REQUEST_CODE_SAVE_XML = 1001
private lateinit var xmlContent: String // 预先生成的XML内容

fun launchSaveFilePicker(activity: Activity) {
    val saveIntent = Intent(Intent.ACTION_CREATE_DOCUMENT).apply {
        addCategory(Intent.CATEGORY_OPENABLE)
        type = "application/xml"
        putExtra(Intent.EXTRA_TITLE, "导出数据.xml")
        // 设置初始打开目录为Download
        putExtra(DocumentsContract.EXTRA_INITIAL_URI, MediaStore.Downloads.EXTERNAL_CONTENT_URI)
    }
    activity.startActivityForResult(saveIntent, REQUEST_CODE_SAVE_XML)
}

// 在Activity的onActivityResult中处理结果
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE_SAVE_XML && resultCode == RESULT_OK) {
        data?.data?.let { uri ->
            contentResolver.openOutputStream(uri)?.use { outputStream ->
                outputStream.write(xmlContent.toByteArray())
            }
        }
    }
}

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