第2章 开发环境搭建：添加DataStore依赖、Kotlin协程与Flow准备、最低SDK版本要求

搭建稳固的开发环境是使用DataStore实现偏好设置持久化的第一步。本章覆盖Gradle依赖配置、Kotlin协程与Flow支持库引入、最低Android SDK版本要求，以及环境验证与常见问题排查。

2.1 最低SDK版本要求

DataStore基于Kotlin协程和Flow实现，对Android API级别有明确的基线要求。下表列出各组件的兼容范围：

2.2 添加DataStore依赖

在模块级 build.gradle 文件中添加DataStore依赖。根据项目需求选择 Preferences DataStore 或 Proto DataStore：

// 模块级 build.gradle (Module: app)
android {
    compileSdk 34
    defaultConfig {
        minSdk 21
        targetSdk 34
        // ...
    }
}

dependencies {
    // Preferences DataStore (键值对存储，无需protobuf)
    implementation "androidx.datastore:datastore-preferences:1.1.1"

    // Proto DataStore (类型化对象存储，需配置protobuf插件)
    // implementation "androidx.datastore:datastore-core:1.1.1"
    // 如需使用Protocol Buffers，还需添加protobuf-gradle-plugin及proto文件编译配置
}

2.3 Kotlin协程与Flow准备

DataStore的读写操作全部基于协程和Flow，必须引入以下依赖以提供运行时支持：

dependencies {
    // Kotlin协程核心库 (提供协程作用域与调度器)
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.1"
    // Android协程支持 (提供 Dispatchers.Main)
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1"

    // Lifecycle协程扩展 (用于 ViewModelScope、lifecycleScope)
    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.8.7"
    // LiveData协程扩展 (如需将Flow转为LiveData)
    implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.8.7"
}

Flow是DataStore读取数据的核心抽象，DataStore的 data 属性直接返回 Flow<T>，支持响应式观察数据变化。在ViewModel或Composable中通过 .collect() 或 .map() 处理数据流。

2.4 同步项目与验证

添加完依赖后，执行以下步骤验证环境：

1. 点击 Android Studio 工具栏中的 Sync Now 触发Gradle同步。
2. 同步成功后，打开 Project > External Libraries，确认以下依赖包已正确下载：

androidx.datastore:datastore-preferences:1.1.1
kotlinx-coroutines-core:1.8.1
kotlinx-coroutines-android:1.8.1
androidx.lifecycle:lifecycle-runtime-ktx:2.8.7

2.5 常见环境问题排查

下图展示了DataStore开发环境的完整依赖层次结构，从Android项目到build.gradle，再到各个运行时组件：