Kotlin中点击按钮选择CSV文件并获取文件名的问题

你的代码问题分析 #

• 初始代码：用ACTION_PICK搭配直接拼接的本地路径Uri，不符合Android文件访问规范（尤其是Android 10+的沙箱机制），系统无法识别这种Uri，因此只会显示照片、联系人这类默认选项。
• 修改后代码：改用ACTION_VIEW是用于打开文件的动作，而非选择文件，进入Download目录后点击文件会触发打开操作，但因缺少正确的文件访问权限，导致无法打开。

正确实现方案 #

要选择CSV文件并获取文件名，需使用官方推荐的文件选择合约ActivityResultContracts.OpenDocument，以下是完整适配代码：

class MainActivity : AppCompatActivity() {
    // 注册文件选择的结果回调
    private val pickCsvLauncher = registerForActivityResult(ActivityResultContracts.OpenDocument()) { uri: Uri? ->
        uri?.let {
            // 获取选中的CSV文件名
            val fileName = getFileNameFromUri(it)
            // 后续处理：读取CSV内容并存入SQLite
            readCsvAndSaveToSqlite(it)
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val btn_csv_me = findViewById<Button>(R.id.btnCSV)
        btn_csv_me.setOnClickListener {
            // 唤起文件选择器，仅显示CSV格式文件
            pickCsvLauncher.launch(arrayOf("text/csv", "application/vnd.ms-excel"))
        }
    }

    // 通过Uri获取文件名的通用方法
    private fun getFileNameFromUri(uri: Uri): String? {
        var fileName: String? = null
        val cursor = contentResolver.query(uri, null, null, null, null)
        cursor?.use {
            if (it.moveToFirst()) {
                // 跨版本通用的文件名列
                val nameIndex = it.getColumnIndex(OpenableColumns.DISPLAY_NAME)
                fileName = it.getString(nameIndex)
            }
        }
        return fileName
    }

    // 读取CSV内容并存入SQLite的示例方法
    private fun readCsvAndSaveToSqlite(uri: Uri) {
        contentResolver.openInputStream(uri)?.use { inputStream ->
            BufferedReader(InputStreamReader(inputStream)).use { reader ->
                var line: String?
                // 跳过表头（如果有），按需调整
                reader.readLine()
                while (reader.readLine().also { line = it } != null) {
                    // 解析CSV行数据，示例按逗号分割列
                    val columns = line?.split(",")
                    columns?.let {
                        // 这里写入你的SQLite插入逻辑
                    }
                }
            }
        }
    }
}

关键说明 #

• ActivityResultContracts.OpenDocument：官方推荐的文件选择合约，适配全Android版本，返回的Uri支持持久化访问（如需长期操作，可调用takePersistableUriPermission获取权限）。
• 指定MIME类型：launch方法传入CSV对应的MIME类型，确保文件选择器只展示CSV文件，避免用户误选。
• 文件名获取：通过ContentResolver查询OpenableColumns.DISPLAY_NAME列，是跨版本通用的安全方式，无需直接操作本地文件路径。
• 文件读取：使用contentResolver.openInputStream(uri)获取输入流，符合Android沙箱机制，Android 10+无需申请READ_EXTERNAL_STORAGE权限。

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