Android中通过Intent实现Deep Linking失效问题求助

我来帮你搞定这个Deep Linking的问题，咱们从APP配置到网页逻辑一步步梳理：

一、补全APP端的Deep Link Intent Filter配置 #

你提供的SplashActivity配置不完整，这是导致链接没反应的核心原因之一。正确的Deep Link配置需要添加专门的Intent Filter来匹配你的分享链接，同时保留原有的启动入口。修改后的AndroidManifest.xml代码如下：

<activity android:name=".activities.SplashActivity" android:screenOrientation="portrait">
    <!-- 保留原有的APP启动入口配置 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

    <!-- 新增Deep Link专属的Intent Filter -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- 匹配http协议的分享链接 -->
        <data
            android:scheme="http"
            android:host="domain.be"
            android:pathPrefix="/app_name/users/shareItem/" />
        <!-- 加上https协议的匹配，覆盖更多场景 -->
        <data
            android:scheme="https"
            android:host="domain.be"
            android:pathPrefix="/app_name/users/shareItem/" />
    </intent-filter>
</activity>

关键说明： #

• android:autoVerify="true"：让系统自动验证你的域名与APP的关联，避免用户看到烦人的选择弹窗。
• data标签：必须精确匹配你的分享链接的协议（http/https）、域名（domain.be）和路径前缀，这样系统才能识别这个链接属于你的APP。

接下来，在SplashActivity里添加Deep Link参数的处理逻辑，这样唤起APP后能跳转到对应的页面：

// Kotlin示例代码，Java写法类似
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 处理启动时的Deep Link
    handleDeepLink(intent)
}

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    // 处理APP后台运行时唤起的Deep Link
    handleDeepLink(intent)
}

private fun handleDeepLink(intent: Intent?) {
    intent?.data?.let { uri ->
        // 解析链接里的商品ID，比如你的链接最后一段MTY1
        val itemId = uri.lastPathSegment ?: ""
        // 跳转到商品详情页或做其他业务处理
        val detailIntent = Intent(this, ItemDetailActivity::class.java)
        detailIntent.putExtra("ITEM_ID", itemId)
        startActivity(detailIntent)
    }
}

二、网页端实现智能跳转逻辑 #

光APP配置好还不够，你的分享链接对应的网页需要做跳转逻辑：先尝试唤起APP，如果失败（用户没装APP），自动跳转到Google Play商店。

在网页的JS里添加这段代码：

function tryOpenApp() {
    // 构造Android Intent链接，替换成你的APP包名
    const intentUrl = 'intent://domain.be/app_name/users/shareItem/MTY1#Intent;scheme=http;package=com.your.app.package;end';
    // 先尝试唤起APP
    window.location.href = intentUrl;
    
    // 设置2秒超时，若没唤起成功则跳转到Google Play
    setTimeout(() => {
        window.location.href = 'https://play.google.com/store/apps/details?id=com.your.app.package';
    }, 2000);
}

// 页面加载时自动执行跳转逻辑
window.addEventListener('load', tryOpenApp);

注意事项： #

• 把com.your.app.package替换成你APP的实际包名（比如com.example.shop）。
• 超时时间可以根据需求调整，1-3秒都比较合适，太短可能会误判，太长用户会等待。

三、验证配置是否正确 #

1. 用ADB命令测试APP端配置：
   打开终端执行以下命令，替换包名后，如果能直接唤起SplashActivity并跳转到详情页，说明APP配置没问题：

adb shell am start -W -a android.intent.action.VIEW -d "http://domain.be/app_name/users/shareItem/MTY1" com.your.app.package

2. 浏览器测试：
   在手机浏览器里打开你的分享链接，测试两种场景：

• 已安装APP：应该直接唤起APP并跳转到对应页面。
• 未安装APP：应该自动跳转到Google Play商店的APP详情页。

常见问题排查 #

• 检查Intent Filter里的data标签是否和你的分享链接完全匹配，比如scheme、host、pathPrefix有没有拼写错误。
• 确保网页里的包名和APP的实际包名完全一致。
• Android 12及以上系统，需要在AndroidManifest.xml里添加<queries>标签，允许APP查询浏览器等应用：

<queries>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="http" />
    </intent>
</queries>

• 部分浏览器可能需要用户手动开启“允许唤起APP”的权限，或者在浏览器设置里调整相关选项。

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