android/nav3-recipes

In general a scene implementation is expected to override key/entries/previousEntries/metadata in a specific way override equals/hashcode to preserve identity across recompositions To reduce boilerplate in general, we can consider an abstract class that implements the expected behaviour while still allowing users to override behavior if necessary: abstract class DecoratorScene<T: Any>(scene: Scene<T>) : Scene<T> { override val key = scene::class to scene.key override val entries = scene.entries override val previousEntries = scene.previousEntries override val metadata = scene.metadata override fun equals(other: Any?): Boolean = { ... } override fun hashCode(): Int { ... } }

Consider adding a helper function to remember and persist a NavKey. Example use case: When implementing multiple back stacks, you can use rememberNavBackStack to create saveable back stacks. val stacks : Map<NavKey, MutableStateList<NavKey>> = mapOf( RouteA to rememberNavBackStack(RouteA), RouteB to rememberNavBackStack(RouteB) ) But you also need to keep track of, and persist the key for the current stack. Currently you need to do the following: val topLevelRoute = rememberSerializable( serializer = MutableStateSerializer(NavKeySerializer()) ){ mutableStateOf<NavKey>(RouteA) } It'd be helpful if you could just do: rememberNavKey(RouteA)

Examples: https://issuetracker.google.com/issues/512958359

Currently, DeepLinkMatcher is the only official way to associate a key that supports a deep link to the type of deep link it supports. (i.e. UriDeepLinkMatcher associates the key : T with the url pattern it supports). Developers may optionally want to colocate them, i.e. interface DeepLinkKey { val uriPattern: String } data class UserKey( val id: Int ): DeepLinkKey { override val uriPattern: String get() = "www.nav3recipes.com/user/{id}" } Create a recipe showing such an interface and how to use it.

Use the DeepLinkMatcher.withBackStack api. The recipe should show conditional back stack building based on deep link key's properties, i.e. something like this https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:navigation3/navigation3-runtime/samples/src/main/kotlin/androidx/navigation3/runtime/samples/deeplink/DeepLinkMatcherSample.kt;l=77?q=deeplinksampl