如何向Jetpack Compose Navigation传递StringArrayType类型参数？

方法一：通过Bundle直接传递（推荐） #

这种方式无需修改路由结构，直接利用Jetpack Navigation的Bundle参数传递数组，是最直接的实现方式。

1. 保持Screen路由定义不变

你的现有Screen密封类可以保留，其中的withArgs方法依然适用于单个字符串参数的场景：

sealed class Screen(val route: String) {
    object PrivacyPolicyScreen: Screen("privacy_policy_screen")
    object DownloadImageScreen: Screen("download_image_screen")
    object DrawingScreen: Screen("drawing_screen")
    object GenerationResultScreen: Screen("generation_result_screen")
    
    fun withArgs(vararg args: String) : String{
        return buildString {
            append(route)
            args.forEach {arg ->
                append("/$arg")
            }
        }
    }
}

2. 正确注册目的地参数

注册GenerationResultScreen时，声明StringArrayType类型的参数：

composable(
    route = Screen.GenerationResultScreen.route, 
    arguments = listOf(
        navArgument("urls") {
            type = NavType.StringArrayType
            nullable = true // 根据需求设置是否允许为空
        }
    )
) { entry ->
    val urls = entry.arguments?.getStringArray("urls")
    GenerationResultScreen(navController = navController, urls = urls)
}

3. 导航时传递字符串数组

导航到目标页面时，将数组放入Bundle并通过navigate的参数传递：

// 示例字符串数组
val imageUrls = arrayOf("https://example.com/img1.jpg", "https://example.com/img2.jpg")

// 执行导航
navController.navigate(Screen.GenerationResultScreen.route) {
    arguments = Bundle().apply {
        putStringArray("urls", imageUrls)
    }
}

方法二：转为JSON字符串通过路径参数传递（适用于深层链接场景） #

如果需要通过URL路径传递数组（比如支持深层链接），可以将数组序列化为JSON字符串，作为单个参数传递，再在目的地解析。

1. 修改Screen的参数拼接方法

引入JSON库（如Gson），新增支持JSON参数的拼接方法：

import com.google.gson.Gson
import java.net.URLEncoder
import java.nio.charset.StandardCharsets

sealed class Screen(val route: String) {
    // ... 其他页面定义不变
    
    fun withJsonArgs(vararg args: Any): String {
        return buildString {
            append(route)
            val gson = Gson()
            args.forEach { arg ->
                val json = gson.toJson(arg)
                // 编码URL避免特殊字符冲突
                append("/${URLEncoder.encode(json, StandardCharsets.UTF_8.name())}")
            }
        }
    }
}

2. 更新目的地路由与参数注册

修改路由为包含参数占位符的形式，参数类型设为StringType：

composable(
    route = "${Screen.GenerationResultScreen.route}/{urls}", 
    arguments = listOf(
        navArgument("urls") {
            type = NavType.StringType
        }
    )
) { entry ->
    val encodedJson = entry.arguments?.getString("urls")
    val urls = encodedJson?.let {
        Gson().fromJson(URLEncoder.decode(it, StandardCharsets.UTF_8.name()), Array<String>::class.java)
    }
    GenerationResultScreen(navController = navController, urls = urls)
}

3. 导航时传递JSON化的数组

val imageUrls = arrayOf("https://example.com/img1.jpg", "https://example.com/img2.jpg")
navController.navigate(Screen.GenerationResultScreen.withJsonArgs(imageUrls))

两种方式对比 #

• Bundle传递：无需额外依赖，实现简单，适合普通导航场景，无法直接用于深层链接。
• JSON转字符串：支持深层链接，需要依赖JSON库，需处理URL编码和解码。

内容的提问来源于stack exchange，提问作者Dmitry Avdoshin