Firebase Dynamic Link在Chrome中无法跳转APP的问题及代码层解决方案咨询

嘿，我之前也碰到过Chrome下Firebase动态链接没法唤起APP的问题——别的浏览器都正常就Chrome不行，真的挺闹心的。先给你讲清楚Chrome和其他浏览器的核心差异，再一步步说Android Studio里的代码解决方案。

Chrome与其他浏览器的核心差异点 #

• 自定义Scheme的限制更严格：Chrome在Android 12+系统中对自定义scheme（比如yourapp://）的跳转有额外限制，会优先打开网页而非直接唤起APP；而Firefox、Safari等浏览器对自定义scheme的兼容性更好，会直接触发APP的跳转Intent。
• 中间预览页的处理逻辑不同：Chrome会先加载Firebase Dynamic Link的官方中间跳转页（用来判断是否唤起APP），如果你的APP没有正确关联这个预览页的域名，Chrome就会停留在网页端；其他浏览器可能会跳过预览页，直接尝试唤起APP。
• Android 12+包可见性规则执行更彻底：Chrome严格遵循Android 12+的包可见性要求，如果你的APP没有声明能处理Firebase动态链接域名的权限，Chrome无法检测到你的APP，自然不会唤起它；部分其他浏览器对这个规则的执行没有这么严格。

Android Studio中的代码层解决方案 #

1. 配置Android App Links（推荐首选方案） #

这是Chrome官方认可的方式，使用HTTPS scheme，不需要用户手动确认跳转，体验最优。

• 在AndroidManifest.xml的Launcher Activity中添加以下Intent Filter，替换成你的Firebase动态链接域名：

<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" />
    <!-- 替换为你的Dynamic Link域名，例如https://yourapp.page.link -->
    <data android:scheme="https"
          android:host="yourapp.page.link" />
</intent-filter>

• 回到Firebase控制台的动态链接设置页面，完成域名与Android应用的关联（Firebase会引导你上传assetlinks.json文件到域名根目录，Chrome通过这个文件验证APP和域名的绑定关系）。

2. 处理Chrome的中间预览页跳转 #

如果暂时无法配置App Links，可以通过Firebase SDK获取深层链接数据：

• 在Launcher Activity的onCreate方法中添加逻辑，解析动态链接：

// 导入Firebase Dynamic Links依赖
import com.google.firebase.dynamiclinks.FirebaseDynamicLinks

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    FirebaseDynamicLinks.getInstance()
        .getDynamicLink(intent)
        .addOnSuccessListener(this) { pendingLinkData ->
            pendingLinkData?.link?.let { deepLink ->
                // 这里处理深层链接逻辑，比如跳转到对应页面
                navigateToTargetPage(deepLink)
            }
        }
        .addOnFailureListener(this) { e ->
            Log.w(TAG, "解析动态链接失败", e)
        }
}

private fun navigateToTargetPage(deepLink: Uri) {
    // 根据deepLink的参数跳转到对应页面，示例：
    val targetId = deepLink.getQueryParameter("target_id")
    if (!targetId.isNullOrEmpty()) {
        startActivity(Intent(this, TargetActivity::class.java).apply {
            putExtra("TARGET_ID", targetId)
        })
    }
}

• 同时确保Activity的launchMode设置为singleTask或singleTop，避免重复创建实例：

<activity
    android:name=".MainActivity"
    android:launchMode="singleTask">
    <!-- 其他配置 -->
</activity>

3. 适配Android 12+的包可见性 #

在AndroidManifest.xml的根节点下添加<queries>标签，声明对Firebase动态链接域名的访问权限：

<queries>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="https" android:host="yourapp.page.link" />
    </intent>
</queries>

这样Chrome就能检测到你的APP可以处理该域名的链接了。

4. 测试跳转逻辑 #

用adb命令快速测试Chrome下的跳转效果：

adb shell am start -a android.intent.action.VIEW -d "https://yourapp.page.link/your_test_link" com.your.package.name

如果能直接唤起APP并跳转到对应页面，说明配置生效。

内容的提问来源于stack exchange，提问作者Raj Kamal Jaiswal