如何在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
相关产品推荐
相关产品推荐

