You need to enable JavaScript to run this app. 如何在Android Studio Kotlin中程序化导入解析本地JSON文件
优惠活动
大模型
产品
解决方案
定价
更多

如何在Android Studio Kotlin中程序化导入解析本地JSON文件

Android Kotlin 读取本地JSON文件并解析实现方案

前置说明

若你存放的data.json在应用私有目录(/Android/data/你的包名/),无需申请任何存储权限,可直接按绝对路径读取;若文件存在设备公共存储目录(比如下载文件夹、文档目录),需要按版本要求配置对应存储权限。

1. 公共存储场景的权限配置

  • Android 12(API 32)及以下:在AndroidManifest.xml中声明READ_EXTERNAL_STORAGE权限,运行时动态申请该权限
  • Android 13(API 33)及以上:替换为声明READ_MEDIA_DOCUMENTS权限,无需申请旧的宽范围存储权限

2. 用系统文件选择器定位文件

不要硬编码公共存储的绝对路径(新版本安卓权限限制下几乎拿不到文件),用官方推荐的Activity Result API调系统文件选择器拿到文件的Uri是最稳定的方案:

// 注册文件选择启动器,回调拿到选中文件的Uri
private val jsonSelectLauncher = registerForActivityResult(ActivityResultContracts.OpenDocument()) { fileUri ->
    fileUri ?: return@registerForActivityResult
    // 拿到Uri后执行读取解析流程
    readJsonFromUri(fileUri)
}

触发文件选择的调用代码:

// 启动选择器,过滤仅展示JSON类型文件
jsonSelectLauncher.launch(arrayOf("application/json"))

3. 读取Uri对应的JSON文本内容

通过ContentResolver打开输入流读取文本,不需要额外做路径转换,用Kotlin的use块自动释放流资源:

private fun readJsonFromUri(uri: Uri) {
    val jsonContent = try {
        contentResolver.openInputStream(uri)?.bufferedReader().use { reader ->
            reader?.readText().orEmpty()
        }
    } catch (e: Exception) {
        e.printStackTrace()
        ""
    }
    parseJsonString(jsonContent)
}

4. 匹配给定结构解析JSON

你的目标JSON结构为{"name": "Dame", "age": "23","gender": "female"},可以直接用安卓自带的org.json库解析,不需要引入第三方依赖:

private fun parseJsonString(jsonStr: String) {
    if (jsonStr.isBlank()) return
    try {
        val jsonObj = JSONObject(jsonStr)
        val name = jsonObj.getString("name")
        val age = jsonObj.getString("age")
        val gender = jsonObj.getString("gender")
        // 拿到解析后的字段值,可直接绑定到UI或做后续业务处理
        binding.tvResult.text = "姓名:$name\n年龄:$age\n性别:$gender"
    } catch (e: Exception) {
        e.printStackTrace()
    }
}

如果习惯用Gson快速解析,可先定义匹配结构的数据类:

data class UserInfo(
    val name: String,
    val age: String,
    val gender: String
)

解析时直接序列化:

val userInfo = Gson().fromJson(jsonStr, UserInfo::class.java)

对应Gson依赖可在模块级build.gradle中添加:implementation "com.google.code.gson:gson:2.10.1"

高频踩坑提醒

  • 不要硬编码/sdcard/、/data/开头的绝对路径访问公共文件,新版本安卓的分区存储机制会直接拦截这类访问
  • 读取文件流后必须通过use块自动关闭流,避免出现内存泄漏
  • Android 13以上还申请旧的READ_EXTERNAL_STORAGE权限,会被系统直接判定权限申请失败

内容的提问来源于stack exchange,提问作者Dame Koalala

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 00:06:04