Hello, I am trying the navigation kotlin dsl (not ...

# android

[Rohan Maity]

Hello, I am trying the navigation kotlin dsl (not jetpack compose one) , in here, I am having issues while sending optional arguements to the route and I cannot find any documentation for it as well
https://developer.android.com/guide/navigation/navigation-kotlin-dsl


UPDATE

Solution to this is the same as compose navigation optional args, so one can refer that

[itnoles]

https://developer.android.com/guide/navigation/navigation-kotlin-dsl#args ?

[Rohan Maity]

This does not tell how to pass optional args for example Query params may or may not come, but Path params must exist for proper routing

[Ian Lake]

It sounds like you've already figured it out? You either include them in the route when you call navigate or you don't. It is just a string

[Rohan Maity]

yes I figured it out.
I did not try with omitting string, but here is what i found out

When you build the route for fragmentDestination like this

fragment<F>(route)

then this route should be format

"baseRoute/{permanent_arg1_name}/{permanent_arg_2_name}?optionalArg1Name={optionalArg1Name}&optionalArg2Name={optionalArg2Name}"

This because when fragment destination is built, it uses the argument name to build the route and when you route using navigate(), one has to pass the values for placeHolder so that they can match against values with which route has been created

Notice how the name as been used for optionalArgs as well this because and argument is built with this very name in fragment dsl, so when building route, use the very same name for placeHolders even in optionalArgs (just like normal args)

[Ian Lake]

Well, no. the optionalArg1Name= could be any key; Nothing cares what that key is

[Ian Lake]

I had a stack overflow answer about this: https://stackoverflow.com/a/65544413/1676363

[Rohan Maity]

I am not talking about key , I ma taking about the plaecHolder values ones in {}

[Ian Lake]

which points out that the routes follow the exact same rules as any implicit deep link: https://developer.android.com/guide/navigation/navigation-deep-link#implicit

[Ian Lake]

Which documents exactly how placeholders, path parameters, and query parameters all work

[Ian Lake]

We do explicitly call this out in the Navigation Compose docs (that link between routes and implicit deep links for how arguments work): https://developer.android.com/jetpack/compose/navigation#nav-with-args

[Ian Lake]

But perhaps what you're missing was that same type of thing on the Kotlin DSL page?

[Rohan Maity]

My point was about the placeHolder values only
like if fragment is build like this in navigation kotlin dsl (not compose one)

fragment<PlantDetailFragment>("${nav_routes.plant_detail}?plant_id="{${nav_arguments.plant_id}}") {
    label = resources.getString(R.string.plant_detail_title)
    argument(nav_arguments.plant_id) {
        type = NavType.StringType
    }
}

then the name used in argument building should match the one in fragment destination route building in placeHolders (ones in curly braces {}) so that arguments when passed during navigating using navigate() could match the proper placeholders

[Ian Lake]

The ${random_kotlin_code} syntax is part of Kotlin, you're not actually putting any braces in your actual string in that code

[Ian Lake]

And the Compose DSL is literally the same DSL. There is only one DSL 🙂

[Ian Lake]

the fragment method is a different method than the composable one though

[Rohan Maity]

The ${random_kotlin_code} syntax is part of Kotlin, you're not actually putting any braces in your actual string in that code

I am sorry I added them now
here is the updated string
"${nav_routes.plant_detail}?plant_id="{${nav_arguments.plant_id}}"

Notice the extra {} it was after this navigation dsl works

[Ian Lake]

Yes, that is how you do optional arguments in both implicit deep links and routes - using query parameters

[Rohan Maity]

And the Compose DSL is literally the same DSL. There is only one DSL 🙂

Yes, after going through compose, one can infer this,

but IMHO,
• there should have been section of optional args in Navigation kotlin dsl (not compose one) or atleast a link referring to compose doc.
• Also documentation of Navigation kotlin dsl is kinda incorrect here: https://developer.android.com/guide/navigation/navigation-kotlin-dsl#navgraphbuilder. It does not tell about those extra {} I agree so far people have figured out on their own or through compose, but I think this should be fixed as well

[Ian Lake]

Makes sense to me! Can you file a docs issue and include a link to it here? https://issuetracker.google.com/issues/new?component=192697

[Ian Lake]

I suspect that second part is more a simple oversight in the code snippet than anything intentionally left out

[Rohan Maity]

Sure will file a ticket on Issue tracker

Also one more thing, I am not sure but I heard from somewhere that one can contribute to android documentation as well, If this is still the case, can I contribute here?

[Ian Lake]

Javadoc, yes, guides on developer.android.com, no, unfortunately

[Rohan Maity]

Ok got it. Will file a create a ticket only then