如何创建带有输入历史记录的TextField？

要实现APP重启后仍保留TextField输入记录的功能，推荐使用Jetpack DataStore（Preferences版）——它是SharedPreferences的现代替代方案，适配异步响应式场景，能避免SP的线程安全问题。以下是具体实现步骤：

1. 添加DataStore依赖 #

在app模块的build.gradle.kts（或build.gradle）中引入依赖：

dependencies {
    // DataStore Preferences核心依赖
    implementation("androidx.datastore:datastore-preferences:1.0.0")
    // 协程依赖，DataStore需协程支持
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
}

2. 封装DataStore操作类 #

写一个单例工具类，统一处理历史记录的存储、读取逻辑：

import androidx.datastore.core.DataStore
import androidx.datastore.preferences.core.Preferences
import androidx.datastore.preferences.core.edit
import androidx.datastore.preferences.core.stringSetPreferencesKey
import androidx.datastore.preferences.preferencesDataStore
import android.content.Context

// 全局DataStore实例
val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "input_history")

class InputHistoryManager(private val context: Context) {
    private val HISTORY_KEY = stringSetPreferencesKey("text_input_history")

    // 读取历史记录
    suspend fun getInputHistory(): Set<String> {
        return context.dataStore.data.first()[HISTORY_KEY] ?: emptySet()
    }

    // 添加新输入到历史（自动去重，限制最多20条）
    suspend fun addInputToHistory(input: String) {
        if (input.isBlank()) return
        context.dataStore.edit { preferences ->
            val currentHistory = preferences[HISTORY_KEY]?.toMutableSet() ?: mutableSetOf()
            // 移除旧条目再添加，保证最新内容在最前
            currentHistory.remove(input)
            currentHistory.add(input)
            // 限制历史数量，避免存储过多数据
            if (currentHistory.size > 20) {
                currentHistory.remove(currentHistory.first())
            }
            preferences[HISTORY_KEY] = currentHistory
        }
    }
}

3. 在Compose界面中集成 #

结合协程和Compose状态，实现输入保存、历史展示的完整逻辑：

import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.mutableStateListOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import kotlinx.coroutines.launch

@Composable
fun PersistentInputScreen(context: Context) {
    val coroutineScope = rememberCoroutineScope()
    val historyManager = remember { InputHistoryManager(context) }
    val inputText = remember { mutableStateOf("") }
    val historyList = remember { mutableStateListOf<String>() }

    // 初始化时读取历史记录
    LaunchedEffect(Unit) {
        val history = historyManager.getInputHistory()
        historyList.addAll(history.reversed()) // 反转后最新内容显示在顶部
    }

    Column {
        OutlinedTextField(
            value = inputText.value,
            onValueChange = { inputText.value = it },
            label = { Text("输入内容") },
            // 按下回车时保存输入并清空输入框
            onImeAction = {
                coroutineScope.launch {
                    historyManager.addInputToHistory(inputText.value)
                    // 本地更新历史列表，无需重新读取DataStore
                    historyList.apply {
                        remove(inputText.value)
                        add(0, inputText.value)
                        if (size > 20) removeLast()
                    }
                    inputText.value = ""
                }
            }
        )

        Text("输入历史：")
        LazyColumn {
            items(historyList) { item ->
                Text(text = item)
            }
        }
    }
}

备选方案：SharedPreferences #

如果暂时不想迁移到DataStore，也可以用SharedPreferences实现，注意要在IO线程操作避免阻塞主线程：

import android.content.Context
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext

class SPInputHistoryManager(private val context: Context) {
    private val SP_NAME = "input_history_sp"
    private val HISTORY_KEY = "text_history"

    suspend fun getInputHistory(): Set<String> {
        return withContext(Dispatchers.IO) {
            context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE)
                .getStringSet(HISTORY_KEY, emptySet()) ?: emptySet()
        }
    }

    suspend fun addInputToHistory(input: String) {
        if (input.isBlank()) return
        withContext(Dispatchers.IO) {
            val sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE)
            val currentHistory = sp.getStringSet(HISTORY_KEY, mutableSetOf())?.toMutableSet() ?: mutableSetOf()
            currentHistory.remove(input)
            currentHistory.add(input)
            if (currentHistory.size > 20) currentHistory.remove(currentHistory.first())
            sp.edit().putStringSet(HISTORY_KEY, currentHistory).apply()
        }
    }
}

使用时只需将Compose代码中的InputHistoryManager替换为这个SP版本即可。

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