原生移动开发 / 系统课时

Deep Link 深度链接

Deep Link 深度链接

本节把一个外部 URI 接入 Compose 导航图:让系统先把链接交给应用,再由 Navigation 匹配目标页面、提取参数并做校验。完成后可以用 ADB 直接验证从应用外打开指定商品页面。

学习目标

  • 配置可被系统识别的 URI intent-filter
  • 在 Compose 导航目标中声明 Deep Link 并读取路径参数
  • 使用 ADB 验证外部跳转,并对不可信参数做边界处理

URI 如何进入导航图

Deep Link 要成功,需要两层匹配同时成立。Android 的 intent-filter 决定“这个 URI 能否进入当前 Activity”,Navigation 的 Deep Link 规则决定“进入 Activity 后落到哪个目标”。只配置其中一层,都会出现链接打不开或进入应用却无法定位页面的问题。

Deep Link 从外部 URI 到 Compose 目标页面的处理链路

这里使用自定义 scheme 便于本地演示。生产环境如果希望普通 https 链接稳定关联到自己的应用,应进一步采用 Android App Links,并完成域名所有权验证。

配置深度链接目标

片段示例:以下配置放在已有 Compose + Navigation 项目中。先在 AndroidManifest.xml 的 MainActivity 内添加可浏览的 VIEW 过滤器。

xml
<activity
    android:name=".MainActivity"
    android:exported="true">
    <!-- 允许外部应用把自定义 URI 交给 MainActivity -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="anystackdemo" android:host="product" />
    </intent-filter>
</activity>

生效行为:系统会把 anystackdemo://product/... 形式的链接交给该 Activity。随后在 NavHost 中给商品目标声明相同的 URI 规则。

kotlin
composable(
    route = "product/{id}",
    arguments = listOf(navArgument("id") { type = NavType.StringType }),
    deepLinks = listOf(
        navDeepLink { uriPattern = "anystackdemo://product/{id}" }
    )
) { backStackEntry ->
    // URI 参数来自应用外部,先转换成业务真正需要的类型。
    val rawId = backStackEntry.arguments?.getString("id")
    val productId = rawId?.toLongOrNull()

    // 非法参数不进入正常业务页面。
    if (productId != null && productId > 0) {
        ProductScreen(productId = productId)
    } else {
        InvalidLinkScreen()
    }
}

预期结果:当 URI 为 anystackdemo://product/42 时,Navigation 匹配 product/{id},页面收到商品 ID 42;如果路径参数无法转换为正整数,则显示无效链接页面。

从外部触发并验证

安装应用并保证测试设备已被 adb devices 识别后,可以直接发送 VIEW Intent。示例包名按项目实际 applicationId 修改。

bash
# 按当前测试应用的 applicationId 修改包名
PACKAGE="com.example.deeplinkdemo"
adb shell am start -W -a android.intent.action.VIEW -d "anystackdemo://product/42" "$PACKAGE"

预期输出包含成功状态,耗时等动态值可能不同。

text
Status: ok

同时设备应直接显示商品 42 的详情页。若出现“无法解析 Intent”,先检查 Manifest 的 scheme、host 与命令是否逐字一致;若应用已打开但目标页未命中,再检查 uriPattern 和参数名是否一致。

处理不可信参数与边界

Deep Link 参数本质上是外部输入,不能因为已经匹配 URI 就直接信任。ID、枚举值和重定向地址都应在进入业务逻辑前完成格式、范围和权限校验;需要访问受保护内容时,还要在目标页重新检查登录态和授权状态。

如果 Activity 改成 singleTop 等非默认启动模式,新的 Intent 可能通过 onNewIntent() 进入已存在的 Activity,此时要显式把新 Intent 交给 NavController.handleDeepLink()。没有特殊需求时保持默认 standard,可以减少这类额外处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Deep Link 深度链接

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通