如何修改Android地址栏输入Firebase Dynamic Link后的跳转行为？

这个问题我之前帮不少开发者排查过，通常是动态链接配置或者应用深度链接处理的环节出了问题，咱们一步步来定位和解决：

一、检查Firebase动态链接的核心配置 #

首先从链接本身的设置入手，这是最容易出问题的地方：

• 确认深度链接目标是否正确：在Firebase控制台创建动态链接时，「深度链接」字段必须填写你应用内的具体跳转路径（比如 yourapp://detail/1001 或者你的HTTPS格式App Link），而不是直接填Google Play的链接。
• 核对「已安装用户的行为」设置：在动态链接的「高级选项」里，要把「已安装应用的行为」设置为打开应用，而不是「打开Google Play商店」。如果这里选错了，哪怕用户装了应用，也会直接跳商店。

二、确认应用的深度链接/App Links配置是否生效 #

应用端的配置是链接能跳转内部的基础，必须确保以下几点：

• 正确配置Manifest的Intent Filter：在你要处理链接的Activity中添加对应的Intent Filter，比如：

<!-- 处理自定义Scheme的深度链接 -->
<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="yourapp"
        android:host="app" />
</intent-filter>

<!-- 如果用HTTPS格式的App Links，需要添加这个并验证域名 -->
<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" />
    <data
        android:scheme="https"
        android:host="yourdomain.com"
        android:pathPrefix="/deeplink" />
</intent-filter>

• 完成App Links的域名验证：如果用HTTPS格式的链接，必须在你的域名根目录放置 assetlinks.json 文件，并且在Firebase控制台完成域名与应用的关联验证。验证不通过的话，浏览器会忽略App Links配置，直接跳商店。

三、确保Firebase Dynamic Links SDK正确集成并处理链接 #

应用端必须正确接收和处理动态链接数据：

• 集成SDK并在启动时处理链接：在你的启动Activity（比如MainActivity）中添加代码获取动态链接：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 处理动态链接
    Firebase.dynamicLinks
        .getDynamicLink(intent)
        .addOnSuccessListener(this) { pendingDynamicLinkData ->
            pendingDynamicLinkData?.link?.let { deepLink ->
                // 在这里跳转至应用内对应的页面，比如根据deepLink的path处理
                handleDeepLink(deepLink)
            }
        }
        .addOnFailureListener(this) { e ->
            Log.w(TAG, "获取动态链接失败", e)
        }
}

// 处理应用从后台唤醒的情况
override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    intent?.let {
        Firebase.dynamicLinks.getDynamicLink(it)
            .addOnSuccessListener { pendingDynamicLinkData ->
                pendingDynamicLinkData?.link?.let { deepLink ->
                    handleDeepLink(deepLink)
                }
            }
    }
}

• 不要遗漏后台唤醒的处理：如果应用已经在后台运行，浏览器打开链接会触发onNewIntent，所以必须在这里也处理动态链接，否则会导致跳转失效。

四、测试与调试技巧 #

通过以下方法快速定位问题：

• 用Firebase测试链接验证：在Firebase控制台生成测试链接，用已安装应用的设备打开，观察跳转行为。如果测试链接正常，说明之前的正式链接可能配置有误。
• 用ADB命令测试深度链接：直接用ADB命令触发深度链接，验证应用是否能正确响应：

adb shell am start -W -a android.intent.action.VIEW -d "yourapp://app/detail/1001" com.your.package.name

如果这个命令能直接打开应用内对应页面，说明应用端配置没问题，问题出在动态链接的设置上。

• 检查浏览器的App Links权限：部分浏览器（比如Chrome）会让用户选择链接的打开方式，你可以在浏览器设置中找到「应用链接」选项，确认你的应用已经被允许打开对应的链接。

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