原生移动开发 / 系统课时
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 后落到哪个目标”。只配置其中一层,都会出现链接打不开或进入应用却无法定位页面的问题。

这里使用自定义 scheme 便于本地演示。生产环境如果希望普通 https 链接稳定关联到自己的应用,应进一步采用 Android App Links,并完成域名所有权验证。
配置深度链接目标
片段示例:以下配置放在已有 Compose + Navigation 项目中。先在 AndroidManifest.xml 的 MainActivity 内添加可浏览的 VIEW 过滤器。
<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 规则。
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 修改。
# 按当前测试应用的 applicationId 修改包名
PACKAGE="com.example.deeplinkdemo"
adb shell am start -W -a android.intent.action.VIEW -d "anystackdemo://product/42" "$PACKAGE"预期输出包含成功状态,耗时等动态值可能不同。
Status: ok同时设备应直接显示商品 42 的详情页。若出现“无法解析 Intent”,先检查 Manifest 的 scheme、host 与命令是否逐字一致;若应用已打开但目标页未命中,再检查 uriPattern 和参数名是否一致。
处理不可信参数与边界
Deep Link 参数本质上是外部输入,不能因为已经匹配 URI 就直接信任。ID、枚举值和重定向地址都应在进入业务逻辑前完成格式、范围和权限校验;需要访问受保护内容时,还要在目标页重新检查登录态和授权状态。
如果 Activity 改成 singleTop 等非默认启动模式,新的 Intent 可能通过 onNewIntent() 进入已存在的 Activity,此时要显式把新 Intent 交给 NavController.handleDeepLink()。没有特殊需求时保持默认 standard,可以减少这类额外处理。