4. 单例封装与上下文解耦：创建DataStore实例、避免内存泄漏、Application注入

在生产环境中，如果每次使用DataStore都通过context.createDataStore()创建新实例，会带来两个严重问题：

1. 多实例竞争——多个实例操作同一个文件会导致数据不一致甚至IOException；
2. Context泄漏——持有Activity或Fragment的Context会使对象无法被GC回收。

本章通过单例模式+Application注入，保证全局唯一DataStore实例，同时将Context引用限制在Application生命周期内。

4.1 两种主流实现方案对比

本章重点讲解Application注入 + 双重校验锁的纯手动实现方式，不依赖任何第三方框架。

4.2 实现流程：三步完成单例封装

1. 自定义Application类——在onCreate()完成时暴露Application实例；
2. 编写DataStoreManager单例——内部使用context.dataStore委托属性，并使用synchronized代码块保护初始化；
3. 提供顶层扩展函数——给Compose/ViewModel使用者提供无Context调用的入口。

下面接入完整代码实现。

4.3 完整代码实现

第一步：自定义Application

class App : Application() {
    companion object {
        @Volatile
        private lateinit var instance: App

        fun getInstance(): App = instance
    }

    override fun onCreate() {
        super.onCreate()
        instance = this
    }
}

第二步：单例DataStoreManager

object DataStoreManager {
    private const val PREFS_NAME = "user_preferences"

    // 延迟初始化，使用Application级别的Context，避免泄漏
    private val dataStore: DataStore<Preferences> by lazy {
        getApplicationContext().let { context ->
            context.createDataStore(name = PREFS_NAME)
        }
    }

    // 双重校验锁确保只初始化一次Context引用
    @Volatile
    private var appContext: Context? = null

    private fun getApplicationContext(): Context {
        return appContext ?: synchronized(this) {
            appContext ?: App.getInstance().applicationContext.also {
                appContext = it
            }
        }
    }

    // ------------- 对外暴露的操作API -------------
    suspend fun saveString(key: String, value: String) {
        dataStore.edit { prefs ->
            prefs[stringPreferencesKey(key)] = value
        }
    }

    suspend fun getString(key: String): Flow<String?> {
        return dataStore.data.map { prefs ->
            prefs[stringPreferencesKey(key)]
        }
    }

    fun getPreferences(): DataStore<Preferences> = dataStore
}

第三步：在AndroidManifest.xml中声明

<application
    android:name=".App"
    android:icon="@mipmap/ic_launcher"
    ... >
    ...
</application>

4.4 生命周期与内存泄漏分析

对比两种不好的写法：

正确方式：持有Application Context且仅通过lazy初始化一次，这是Android官方推荐的避免泄漏的标准模式。

4.5 单例封装结构图

4.6 如何验证实例唯一性

在Application.onCreate()和ViewModel初始化时打日志，确认DataStore
对象的hashCode()是否一致：

// 在DataStoreManager单例中添加调试代码
init {
    Log.d("DataStoreManager", "DataStore instance hash: ${dataStore.hashCode()}")
}

// 在其他位置调用多次，检查是否同一对象
repeat(3) {
    Log.d("Test", "hash: ${DataStoreManager.getPreferences().hashCode()}")
}

预期输出三个相同的hash值。

4.7 调试与边界处理

• 测试环境中的Application: Robolectric或Instrumentation测试中可使用自定义TestApplication，继承真正的App或mock必要的Context；
• 多进程场景: 默认DataStore不支持多进程读写。如果App有多个进程，每个进程需要使用独立的DataStore文件路径，或在Application中判断进程名；
• Android 12+ Partitioned Storage: DataStore文件存于internal files，不受分区存储影响，无需额外适配。

4.8 性能与稳定性优化