Appstate Statestore

  
--
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2026 年 10 月 28 日 - - - 1.0.0-alpha01

宣告依附元件

如要新增 appstate statestore 的依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

dependencies {
    implementation "androidx.appstate.statestore:statestore:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-android:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-datastore:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-datastore-android:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-desktop:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-iosarm64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-iossimulatorarm64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-js:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-linuxarm64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-linuxx64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-macosarm64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-mingwx64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-tvosarm64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-tvossimulatorarm64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-wasm-js:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-watchosarm32:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-watchosarm64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-watchosdevicearm64:1.0.0-alpha01"
    implementation "androidx.appstate.statestore:statestore-watchossimulatorarm64:1.0.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.appstate.statestore:statestore:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-android:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-datastore:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-datastore-android:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-desktop:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-iosarm64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-iossimulatorarm64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-js:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-linuxarm64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-linuxx64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-macosarm64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-mingwx64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-tvosarm64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-tvossimulatorarm64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-wasm-js:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-watchosarm32:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-watchosarm64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-watchosdevicearm64:1.0.0-alpha01")
    implementation("androidx.appstate.statestore:statestore-watchossimulatorarm64:1.0.0-alpha01")
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

1.0 版本

1.0.0-alpha01 版

2026 年 10 月 28 日

發布 androidx.appstate.statestore:statestore-*:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。

新功能

AppState StateStore 是以 Compose 執行階段為基礎建構的新程式庫，可做為提供自訂整合的包裝函式。androidx.appstate.statestore 構件提供程式庫 API，並隨附 androidx.appstate.statestore:statestore-datastore 構件，用於狀態持續性。開發人員可以使用 StateStore 將快照狀態提升至應用程式層，並使用資料儲存庫整合功能保留該狀態。

class MyApplication : Application() {
    val stateStore = StateStore()
    private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Default)

    override fun onCreate() {
        super.onCreate()

        scope.launch {
            // Start the listener in a child coroutine so it doesn't block the outer scope
            launch {
                try {
                    stateStore
                        .syncToDataStore(dataStoreFile("settings").absolutePath, this)
                } catch (e: Exception) {
                    e.printStackTrace()
                }
            }
        }
    }
}