无需存储权限，通过File Provider保存CSV文件的Kotlin代码需求

在Android 10+的分区存储机制下，直接写入外部公共目录需要存储权限，但结合File Provider和系统Intent，我们可以实现在无需申请权限的前提下，让用户将CSV文件保存到外部存储。以下是完整的实现步骤和代码：

1. 配置File Provider（用于共享私有目录文件） #

如果你的CSV文件先生成在App私有目录，再需要让用户保存到外部存储，需先配置File Provider来授权访问私有文件。

1.1 创建File Provider路径配置文件 #

在res/xml目录下新建file_paths.xml，定义允许共享的私有目录：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 共享App内部存储的files/csv目录 -->
    <files-path name="csv_files" path="csv/"/>
    <!-- 可选：共享App外部私有存储的csv目录 -->
    <external-files-path name="external_csv_files" path="csv/"/>
</paths>

1.2 在Manifest中注册File Provider #

打开AndroidManifest.xml，在<application>标签内添加File Provider注册：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths"/>
</provider>

2. Kotlin核心实现代码 #

2.1 生成CSV文件到私有目录 #

先将CSV内容写入App私有目录，确保文件安全存储：

private fun generateCsvToPrivateDir(): File? {
    // 创建私有目录下的csv文件夹
    val csvDir = File(filesDir, "csv").apply {
        if (!exists()) mkdirs()
    }
    // 生成带时间戳的CSV文件名
    val csvFile = File(csvDir, "export_data_${System.currentTimeMillis()}.csv")

    return try {
        csvFile.bufferedWriter().use { writer ->
            // 写入CSV表头
            writer.write("姓名,年龄,城市\n")
            // 写入数据行
            writer.write("张三,25,北京\n")
            writer.write("李四,30,上海\n")
        }
        csvFile
    } catch (e: IOException) {
        e.printStackTrace()
        null
    }
}

2.2 调用系统Intent让用户保存到外部存储 #

通过ACTION_CREATE_DOCUMENT Intent让用户选择保存位置，再将私有目录的CSV文件复制到目标位置：

private fun startSaveCsvFlow() {
    val privateCsvFile = generateCsvToPrivateDir() ?: return

    // 构建保存文件的Intent
    val saveIntent = Intent(Intent.ACTION_CREATE_DOCUMENT).apply {
        addCategory(Intent.CATEGORY_OPENABLE)
        // 指定文件类型为CSV
        type = "text/csv"
        // 设置默认文件名
        putExtra(Intent.EXTRA_TITLE, "导出数据.csv")
    }

    // 启动Activity等待用户选择保存位置
    startActivityForResult(saveIntent, REQUEST_CODE_SAVE_CSV)
}

// 处理保存结果
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE_SAVE_CSV && resultCode == RESULT_OK) {
        data?.data?.let { targetUri ->
            contentResolver.openOutputStream(targetUri)?.use { outputStream ->
                FileInputStream(generateCsvToPrivateDir()).use { inputStream ->
                    inputStream.copyTo(outputStream)
                }
                Toast.makeText(this, "CSV文件保存成功", Toast.LENGTH_SHORT).show()
            } ?: run {
                Toast.makeText(this, "保存失败：无法获取输出流", Toast.LENGTH_SHORT).show()
            }
        }
    }
}

companion object {
    private const val REQUEST_CODE_SAVE_CSV = 1001
}

2.3 直接生成并保存CSV（无需私有目录中转） #

如果不需要先保存到私有目录，可直接将CSV内容写入用户选择的Uri：

private fun saveCsvDirectly() {
    val saveIntent = Intent(Intent.ACTION_CREATE_DOCUMENT).apply {
        addCategory(Intent.CATEGORY_OPENABLE)
        type = "text/csv"
        putExtra(Intent.EXTRA_TITLE, "直接导出数据.csv")
    }
    startActivityForResult(saveIntent, REQUEST_CODE_SAVE_CSV_DIRECT)
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE_SAVE_CSV_DIRECT && resultCode == RESULT_OK) {
        data?.data?.let { uri ->
            contentResolver.openOutputStream(uri)?.use { outputStream ->
                outputStream.bufferedWriter().use { writer ->
                    writer.write("姓名,年龄,城市\n")
                    writer.write("王五,28,广州\n")
                    writer.write("赵六,32,深圳\n")
                }
                Toast.makeText(this, "CSV文件保存成功", Toast.LENGTH_SHORT).show()
            } ?: run {
                Toast.makeText(this, "保存失败：无法获取输出流", Toast.LENGTH_SHORT).show()
            }
        }
    }
}

companion object {
    private const val REQUEST_CODE_SAVE_CSV_DIRECT = 1002
}

3. 关键注意事项 #

• 该方案适用于Android 10（API 29）及以上，无需申请READ_EXTERNAL_STORAGE或WRITE_EXTERNAL_STORAGE权限；
• 针对Android 9及以下版本，若需写入外部公共目录仍需申请存储权限，可通过版本判断做兼容处理；
• 使用ACTION_CREATE_DOCUMENT符合系统隐私规范，让用户自主选择保存位置，避免权限弹窗带来的用户体验问题。

内容的提问来源于stack exchange，提问作者Awais ul Hassan