Compose Navigation中Deep Links的回退目标实现方案

你的需求是让App接收所有example.com的深度链接，但只有三个特定路径由MainActivity的NavHost处理，其余路径转发到WebViewActivity。之前尝试的example.com/.*模式会覆盖更具体的路径，而在Home目标中手动获取URL又太繁琐，这里提供两种靠谱的解决方法：

方法一：利用Navigation的Activity目的地（导航图内统一管理） #

Navigation支持直接将深度链接导航到Activity，只要确保具体路径的目的地先注册，回退的Activity目的地放在最后，就能让系统优先匹配具体路径，剩下的自动落到回退目标。

修改你的NavHost代码如下：

NavHost(navController = navController, startDestination = "root") {
  // 先注册所有具体的可组合目的地
  composable(
    "root",
    deepLinks = listOf(
      navDeepLink { uriPattern = "example.com" }
    ),
  ) {
    // 你的Root页面逻辑
  }
  composable(
    "account",
    deepLinks = listOf(
      navDeepLink { uriPattern = "example.com/account" }
    ),
  ) {
    // 你的Account页面逻辑
  }
  composable(
    "accountdetail",
    deepLinks = listOf(
      navDeepLink { uriPattern = "example.com/account/detail" }
    ),
  ) {
    // 你的AccountDetail页面逻辑
  }
  
  // 最后注册回退的Activity目的地
  activity(
    "web_view_fallback",
    deepLinks = listOf(
      navDeepLink { uriPattern = "example.com/{.*}" }
    )
  ) {
    // 这里无需编写逻辑，Navigation会自动启动WebViewActivity
    // 你可以在WebViewActivity中通过intent.data获取跳转的URL
  }
}

注意：必须保证回退的Activity目的地在所有具体目的地之后注册，因为Navigation会按顺序匹配深度链接，先匹配到的目标会被优先使用。

方法二：在MainActivity提前拦截深度链接（更高效直接） #

这种方法绕开NavHost的匹配逻辑，直接在MainActivity中判断路径是否属于NavHost处理的范围，不属于就直接启动WebViewActivity，逻辑更清晰，也不会出现匹配优先级问题。

修改MainActivity代码：

class MainActivity : ComponentActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 启动时先处理深度链接
    intent?.let { handleDeepLink(it) }
    
    setContent {
      // 你的NavHost代码
      NavHost(navController = navController, startDestination = "root") {
        // 三个具体目的地的代码不变
      }
    }
  }

  // 处理新的Intent（比如App在后台时收到深度链接）
  override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    intent?.let { handleDeepLink(it) }
  }

  private fun handleDeepLink(intent: Intent) {
    val deepLinkUri = intent.data ?: return
    val path = deepLinkUri.path ?: ""
    
    // 定义NavHost能处理的路径列表
    val handledPaths = listOf("", "/account", "/account/detail")
    
    if (!handledPaths.contains(path)) {
      // 启动WebViewActivity并传递深度链接
      val webIntent = Intent(this, WebViewActivity::class.java).apply {
        data = deepLinkUri
        // 如果不需要保留MainActivity，可以添加以下代码
        // flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
      }
      startActivity(webIntent)
      // 可选：如果不需要停留在MainActivity，调用finish()
      // finish()
    }
  }
}

这种方法的优势是逻辑简单直接，避免了Navigation深度链接匹配的优先级问题，推荐使用。

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