Compose Android深度链接实现与跨端及异常问题咨询

1. 深度链接实现导航链的原生支持方案 #

Android 端 #

可以通过 Jetpack Navigation 组件的原生能力实现：

• 在导航图中配置深层链接时，通过 app:popUpTo 和 app:popUpToInclusive 定义回退栈结构，确保从 user_data 页面返回时回到 user_details。
  示例导航 XML 配置：

  <fragment
      android:id="@+id/user_data_fragment"
      android:name="com.example.UserDataFragment">
      <deepLink app:uri="app://example.com/user_data" />
      <action
          android:id="@+id/action_back_to_details"
          app:destination="@id/user_details_fragment"
          app:popUpTo="@id/user_details_fragment"
          app:popUpToInclusive="false"/>
  </fragment>
  

• 也可以用代码构建包含回退栈的深层链接 Intent：

  val pendingIntent = NavDeepLinkBuilder(context)
      .setGraph(R.navigation.nav_graph)
      .setDestination(R.id.user_data_fragment)
      .setPopUpTo(R.id.user_details_fragment, inclusive = false)
      .createPendingIntent()
  

iOS 端 #

• UIKit 环境下：处理 Universal Link 时直接构建 UINavigationController 的栈，先 push UserDetailsViewController，再 push UserDataViewController，返回按钮会自动回到上一页。
• SwiftUI 环境下：通过 NavigationStack 的 path 状态变量，在解析深层链接时将 UserDetails 和 UserData 依次加入路径，形成完整回退链。

2. KMM 应用中 Compose Navigation 的 deeplinks 参数工作机制及 iOS 端表现 #

Android 端 #

Compose Navigation 的 deeplinks 参数直接和 Jetpack Navigation 深层链接系统集成，定义目的地时添加规则即可自动解析跳转：

composable(
    route = "user_data",
    deepLinks = listOf(navDeepLink { uriPattern = "app://example.com/user_data" })
) {
    UserDataScreen()
}

系统会自动拦截符合规则的深层链接，直接导航到对应 Compose 目的地，同时遵循导航栈的配置逻辑。

iOS 端 #

目前 Compose for iOS 没有原生自动支持 deeplinks 参数的解析，需要手动打通原生与共享模块的导航逻辑：

1. 在 KMM 共享模块中统一定义 Compose Navigation 的路由和深层链接规则，与 Android 端保持一致。
2. 在 iOS 端的 AppDelegate 或 SceneDelegate 中处理 Universal Link/URL Scheme，获取链接后传递给共享模块的导航逻辑。
3. 共享模块接收到链接后，调用 Compose Navigation 的 navigate 方法完成页面跳转。

3. 深度链接错误后重新访问的处理及存储方式 #

• 存储位置：
  • Android 端可将链接存储在 SharedPreferences 中；若包含敏感信息，可使用 EncryptedSharedPreferences。
  • iOS 端存储在 UserDefaults（非敏感链接）或 Keychain（敏感链接）；也可在错误页的 ViewModel 中临时持有链接。
• 重新访问逻辑：
  1. 监听网络状态变化：Android 用 ConnectivityManager，iOS 用 NWPathMonitor。
  2. 网络恢复后，从存储中取出链接，重新调用深层链接处理逻辑（比如 Android 调用 navController.navigate(Uri.parse(link))，iOS 触发共享模块的导航方法）。
  3. 也可在错误页面提供重试按钮，用户主动点击时直接重新处理存储的链接。

内容的提问来源于stack exchange，提问作者Сергей Беляков