Appstate Transform
| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |
|---|---|---|---|---|
| November 18, 2026 | - | - | - | 1.0.0-alpha03 |
Declaring dependencies
To add a dependency on appstate transform, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.
Add the dependencies for the artifacts you need in the build.gradle file for
your app or module:
Groovy
dependencies { implementation "androidx.appstate.transform:transform:1.0.0-alpha03" implementation "androidx.appstate.transform:transform-testing:1.0.0-alpha03" implementation "androidx.appstate.transform:transform-testing-wasm:1.0.0-alpha03" implementation "androidx.appstate.transform:transform-wasm:1.0.0-alpha03" }
Kotlin
dependencies { implementation("androidx.appstate.transform:transform:1.0.0-alpha03") implementation("androidx.appstate.transform:transform-testing:1.0.0-alpha03") implementation("androidx.appstate.transform:transform-testing-wasm:1.0.0-alpha03") implementation("androidx.appstate.transform:transform-wasm:1.0.0-alpha03") }
For more information about dependencies, see Add build dependencies.
Feedback
Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.
See the Issue Tracker documentation for more information.
Version 1.0
Version 1.0.0-alpha03
November 18, 2026
androidx.appstate.transform:transform-*:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.
API Changes
AppState Transformhas added support forSavedStateContainerthat enables the use ofrememberSaveableinside of the@Composablelambda. The ensures that all of the state inside the transform is not saved across configuration changes and process death. (Ia66ea)AppState Transformnow provides aRunnableTransformScopethat provides a publicrunfunction to kick off the scope while the defaultTransformScopeinterface can continue to be used forlaunchTransformwith the assumption that the scope is already running. (Ia1f0d)
Version 1.0.0-alpha02
November 04, 2026
androidx.appstate.transform:transform-*:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.
Version 1.0.0-alpha01
October 28, 2026
androidx.appstate.transform:transform-*:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.
New Features
AppState Transform is a new library built on the Compose runtime that allows for running a composition outside of your UI. The androidx.appstate.transform:transform artifact provides the library APIs and it also comes with a androidx.appstate.transform:transform-testing artifact for testing. Developers can use Transform to manage their composition anywhere within their app.
// With helper function
var sourceState by mutableStateOf(0)
val state = transform(initialValue = 0, scope = myCoroutineScope) {
// any time this state changes, this lambda will update
sourceState
}
// With TransformScope directly
val transformScope = TransformScope()
var sourceState by mutableStateOf(0)
val state = transformScope.launchTransform(initialValue = 0) {
// any time this state changes, this lambda will update
sourceState
}
myCoroutineScope.launch {
try {
transformScope.run()
} finally {
state.dispose()
}
}
// In test with the new transformTest API
@Test
fun testStateUpdate() = transformTest {
var sourceState by mutableStateOf(0)
val state = transform(
initialValue = 0, scope = backgroundScope, dispatcher = testDispatcher
) {
sourceState
}
assertThat(state.value).isEqualTo(0)
sourceState = 1
advance()
assertThat(state.value).isEqualTo(1)
}