OR if you got this error kotlinx.serialization.SerializationException: Serializer for class 'DirectionImpl' is not found.
With the introduction of type safe APIs on the official library, our NavController
extension functions that received Direction
are now shadowed by new member functions on NavController
.
This means that the official member function would be called instead of our extension functions, and so we removed those extension functions.
Instead, always make sure to use DestinationsNavigator
. You can get one of such navigators by:
- If inside a specific screen:
- Simply receive a
DestinationsNavigator
instead ofNavController
in your annotated screens.
- Simply receive a
- If navigating on top level (such as around
DestinationsNavHost
, bottom nav bar, etc)navController.rememberDestinationsNavigator()
if in a ComposablenavController.toDestinationsNavigator()
if not in a Composable
Read more about these changes here.
Compose Destinations provides the correct version transitively.
So, if you have dependency on androidx.navigation:navigation-compose
, please remove it! This has always been true, but more important now.
A KSP library that processes annotations and generates code that uses Official Jetpack Compose Navigation under the hood. It hides the complex, non-type-safe and boilerplate code you would have to write otherwise.
No need to learn a whole new framework to navigate - most APIs are either the same as with the Jetpack Components or inspired by them.
Please consider migrating to it and leaving feedback as GH issue or on our slack channel #compose-destinations!
- Migration guide: https://composedestinations.rafaelcosta.xyz/migrating-to-v2
- V2 docs: https://composedestinations.rafaelcosta.xyz/v2
- Typesafe navigation arguments
- Simple but configurable navigation graphs setup
- Navigating back with a result in a simple and type-safe way
- Getting the navigation arguments from the
SavedStateHandle
(useful in ViewModels) andNavBackStackEntry
in a type-safe way. - Navigation animations
- Destination wrappers to allow reusing Compose logic on multiple screens
- Bottom sheet screens
- Easy deep linking to screens
- Wear OS support (since versions 1.x.30!)
- All you can do with Official Jetpack Compose Navigation but in a simpler safer way!
For a deeper look into all the features, check our documentation website.
Note
This readme is about v2. If you're now starting to use Compose Destinations, I strongly recommend using v2. It is currently in beta stage, but we don't expect major issues with it, and soon it will reach stable! If you really want to see basic v1 usage, check it here.
@Destination<RootGraph> // sets this as a destination of the "root" nav graph
@Composable
fun ProfileScreen() { /*...*/ }
@Destination<RootGraph>
@Composable
fun ProfileScreen(
id: Int, // <-- required navigation argument
groupName: String?, // <-- optional navigation argument
isOwnUser: Boolean = false // <-- optional navigation argument
) { /*...*/ }
Parcelable
, Serializable
, Enum
and classes annotated with @kotlinx.serialization.Serializable
(as well as Array
s and ArrayList
s of these) work out of the box!
You can also make any other type a navigation argument type. Read about it here
Tip
There is an alternative way to define the destination arguments in case you don't need to use them inside the Composable (as is likely the case when using ViewModel). Read more here.
Or run ksp task (example: ./gradlew kspDebugKotlin
), to generate all the Destinations. With the above annotated composable, a ProfileScreenDestination
file would be generated (that we'll use in step 4).
It will have the correct typed arguments.
@Destination<RootGraph>(start = true) // sets this as the start destination of the "root" nav graph
@Composable
fun HomeScreen(
navigator: DestinationsNavigator
) {
/*...*/
navigator.navigate(ProfileScreenDestination(id = 7, groupName = "Kotlin programmers"))
}
DestinationsNavHost(navGraph = NavGraphs.root)
Note
NavGraphs
is a generated file that contains all navigation graphs.
root
here corresponds to the <RootGraph>
we used in the above examples.
You're also able to define your own navigation graphs to use instead of <RootGraph>
.
This call adds all annotated Composable functions as destinations of the Navigation Host.
That's it! No need to worry about routes, NavType
, bundles and strings. All that redundant and
error-prone code gets generated for you.
Compose destinations is available via maven central.
Note: The version you chose for the KSP plugin depends on the Kotlin version your project uses.
You can check https://github.com/google/ksp/releases for the list of KSP versions, then pick the last release that matches your Kotlin version. Example: If you're using1.9.22
Kotlin version, then the last KSP version is1.9.22-1.0.17
.
groovy - build.gradle(:module-name)
plugins {
//...
id 'com.google.devtools.ksp' version '1.9.22-1.0.17' // Depends on your kotlin version
}
kotlin - build.gradle.kts(:module-name)
plugins {
//...
id("com.google.devtools.ksp") version "1.9.22-1.0.17" // Depends on your kotlin version
}
Compose Destinations has multiple active versions. The higher one uses the latest versions for Compose and Navigation, while the others use only stable versions. Choose the one that matches your Compose version, considering this table:
Compose 1.1 (1.1.x) | |
Compose 1.2 (1.2.x) | |
Compose 1.3 (1.3.x) | |
Compose 1.4 (1.4.x) | |
Compose 1.5 (1.5.x) | |
Compose 1.6 (1.6.x) | OR |
Compose 1.7 (1.7.x) | OR |
Warning
If you choose a version that uses a higher version of Compose than the one you're setting for your app, gradle will upgrade your Compose version via transitive dependency.
groovy - build.gradle(:module-name)
implementation 'io.github.raamcosta.compose-destinations:core:<version>'
ksp 'io.github.raamcosta.compose-destinations:ksp:<version>'
// V2 only: for bottom sheet destination support, also add
implementation 'io.github.raamcosta.compose-destinations:bottom-sheet:<version>'
kotlin - build.gradle.kts(:module-name)
implementation("io.github.raamcosta.compose-destinations:core:<version>")
ksp("io.github.raamcosta.compose-destinations:ksp:<version>")
// V2 only: for bottom sheet destination support, also add
implementation("io.github.raamcosta.compose-destinations:bottom-sheet:<version>")
Note
If you want to use Compose Destinations in a Wear OS app, replace above core dependency with:
implementation 'io.github.raamcosta.compose-destinations:wear-core:<version>'
this will use Wear Compose Navigation internally.
Read more about the next steps to configure these features here
Please join the community at Kotlin slack channel: #compose-destinations
Ask questions, suggest improvements, or anything else related to the library.
If you like the library, consider starring and sharing it with your colleagues.