Jetpack DataStore集成报错：Unresolved reference: dataStore问题求助

一、修复「Unresolved reference: dataStore」错误 #

• 补全必要导入语句
  你需要添加DataStore偏好设置相关的导入，否则Kotlin无法识别preferencesDataStore委托方法和相关类型：

  import androidx.datastore.core.DataStore
  import androidx.datastore.preferences.core.Preferences
  import androidx.datastore.preferences.preferencesDataStore
  

• 同步Gradle依赖
  添加依赖后，务必点击Android Studio右上角的「Sync Project with Gradle Files」按钮，确保依赖包已正确下载并引入项目。未同步Gradle会导致依赖类无法被识别。
• 更新依赖版本（可选）
  若1.0.0版本存在兼容问题，可尝试升级至最新稳定版：

  dependencies {
      implementation("androidx.datastore:datastore-preferences:1.1.1")
  }
  

二、消除「Property "dataStore" is never used」警告 #

该警告是因为你仅定义了dataStore扩展属性但未实际调用。只要在代码中使用context.dataStore进行偏好设置的读写操作，警告就会自动消失。示例代码如下：

写入数据示例 #

import androidx.datastore.preferences.core.intPreferencesKey
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext

// 定义偏好键
private val THEME_MODE_KEY = intPreferencesKey("theme_mode")

suspend fun saveThemeMode(context: Context, mode: Int) {
    withContext(Dispatchers.IO) {
        context.dataStore.edit { settings ->
            settings[THEME_MODE_KEY] = mode
        }
    }
}

读取数据示例 #

import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.map

val themeModeFlow: Flow<Int> = context.dataStore.data
    .map { preferences ->
        preferences[THEME_MODE_KEY] ?: 0 // 默认值为0
    }

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