Android应用中读取静态数据文件的方法（Jetpack Compose场景）

1. 静态文件该放哪儿？ #

有两个常用目录可选，按需挑：

• res/raw目录：文件会被Android SDK编译，生成对应的资源ID（比如R.raw.data_csv），适合单个独立文件，读取时直接用资源ID拿输入流，不用手动拼路径。注意文件名只能用小写字母、数字和下划线，不能有特殊字符。
• assets目录：文件保持原始结构，支持子目录，读取时要指定相对路径（比如"data/your_file.csv"）。适合有多层文件结构的场景，或者不想让文件被编译处理的情况。

优先推荐assets，CSV/XML这类纯文本文件不需要资源ID的额外处理，路径控制更灵活。

2. 怎么解析CSV/XML？ #

CSV解析（用Apache Commons CSV，省心） #

先在Module级别的build.gradle里加依赖：

dependencies {
    implementation 'org.apache.commons:commons-csv:1.10.0'
}

然后读取assets里的CSV并解析成对象列表：

// 从assets获取输入流
val inputStream = context.assets.open("your_data.csv")
val reader = BufferedReader(InputStreamReader(inputStream))

// 假设CSV第一行是表头，用表头字段名取值
val csvParser = CSVParser(reader, CSVFormat.DEFAULT.withHeader())
val dataList = mutableListOf<YourDataModel>()

for (record in csvParser) {
    val item = YourDataModel(
        id = record.get("id").toInt(),
        name = record.get("name"),
        // 其他字段按你的数据模型定义来
    )
    dataList.add(item)
}

// 记得关闭流和解析器
csvParser.close()
reader.close()

XML解析（用Android自带的XmlPullParser，不用额外依赖） #

如果用XML，直接用系统API就行，不用加额外依赖：

// 如果文件放res/raw，用资源ID获取解析器
val parser = context.resources.getXml(R.raw.data_xml)
// 如果放assets，这么获取：
// val parser = Xml.newPullParser()
// parser.setInput(context.assets.open("data.xml"), "UTF-8")

val dataList = mutableListOf<YourDataModel>()
var currentItem: YourDataModel? = null
var eventType = parser.eventType

while (eventType != XmlPullParser.END_DOCUMENT) {
    when (eventType) {
        XmlPullParser.START_TAG -> {
            // 遇到item标签，创建新的对象
            if (parser.name == "item") {
                currentItem = YourDataModel()
            }
            // 给当前对象赋值
            currentItem?.let { item ->
                when (parser.name) {
                    "id" -> item.id = parser.nextText().toInt()
                    "name" -> item.name = parser.nextText()
                    // 其他字段对应处理
                }
            }
        }
        XmlPullParser.END_TAG -> {
            // 遇到item结束标签，把对象加入列表
            if (parser.name == "item" && currentItem != null) {
                dataList.add(currentItem)
                currentItem = null
            }
        }
    }
    eventType = parser.next()
}

3. 能在Activity的onCreate里直接读取吗？ #

绝对不行！IO操作是耗时任务，在主线程（比如onCreate）里执行会阻塞UI，轻则启动卡顿，重则触发ANR（应用无响应）。正确做法是：

用ViewModel + 协程把解析逻辑放到后台线程：

class MainViewModel : ViewModel() {
    // 用MutableState给Compose UI传数据
    val dataList = mutableStateOf<List<YourDataModel>>(emptyList())

    init {
        loadStaticData()
    }

    private fun loadStaticData() {
        // 用viewModelScope在后台线程执行解析
        viewModelScope.launch(Dispatchers.IO) {
            val parsedData = // 调用上面的解析方法拿到数据列表
            // 切回主线程更新UI状态
            withContext(Dispatchers.Main) {
                dataList.value = parsedData
            }
        }
    }
}

然后在Compose中观察状态，渲染UI：

@Composable
fun MainScreen(viewModel: MainViewModel = viewModel()) {
    val data = viewModel.dataList.value
    when {
        data.isEmpty() -> {
            // 显示加载状态
            Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
                CircularProgressIndicator()
            }
        }
        else -> {
            // 渲染数据列表
            LazyColumn {
                items(data) { item ->
                    Text(
                        text = item.name,
                        modifier = Modifier.padding(16.dp)
                    )
                }
            }
        }
    }
}

额外优化建议 #

如果数据有数百条，每次启动都解析文件还是会有开销，推荐第一次启动时把解析后的数据导入Room数据库：

1. 启动时检查Room里有没有数据
2. 没有的话，解析CSV/XML并插入Room
3. 后续启动直接从Room查数据，速度更快，还能支持查询、过滤等操作

这样既避免了重复解析的耗时，又能利用Room的缓存优势，适合数据量大的场景。

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