无App Store ID能否使用Firebase Dynamic Link?测试阶段如何配置?
Firebase动态链接测试阶段常见问题&可行方案
核心问题解答:测试阶段无需上传应用到商店
Firebase动态链接的拉起逻辑核心是应用的DeepLink配置,和你有没有上架App Store、Google Play完全无关,测试阶段本地安装的测试包、TestFlight/iOS企业包、Android测试APK都可以正常响应动态链接跳转。
测试阶段直接拉起应用的配置方案
- iOS端配置:
- 先在Xcode项目的Signing & Capabilities里添加Associated Domains,写入你的动态链接域名,格式是
applinks:xxx.page.link(xxx替换成你Firebase控制台分配的动态链接前缀) - 到苹果开发者账号后台,确认你的App ID已经开启了Associated Domains权限,注意测试用的Bundle ID要和Firebase控制台填的iOS Bundle ID完全一致
- 测试时只要你的设备上装了对应Bundle ID的测试包,不管是Debug调试包、TestFlight包还是企业签名包,都能正常被动态链接拉起
- 先在Xcode项目的Signing & Capabilities里添加Associated Domains,写入你的动态链接域名,格式是
- Android端配置:
- 在AndroidManifest.xml的启动Activity节点添加intent-filter,配置好你的动态链接域名、scheme,和你在Firebase控制台填的Android包名完全匹配
- 测试时只要设备安装了对应包名的APK,不管是Debug包还是Release测试包,都能直接响应动态链接跳转
注意:如果测试时点击动态链接跳转到了下载页,优先检查包名/Bundle ID、域名配置是否和Firebase控制台一致,iOS还要确认Associated Domains配置没有拼写错误
实现URL触发Flutter内指定函数的方案
你可以用firebase_dynamic_links官方库完成链路对接,核心逻辑如下:
- 先在pubspec.yaml引入依赖,版本匹配你的Flutter版本即可
- 应用冷启动时获取触发启动的动态链接数据:
// 应用冷启动时获取初始动态链接 final PendingDynamicLinkData? initialLink = await FirebaseDynamicLinks.instance.getInitialLink(); if (initialLink != null) { final Uri deepLink = initialLink.link; // 这里根据deepLink的路径、query参数调用指定函数,比如deepLink.path是'/invite'就调用邀请逻辑 handleDeepLink(deepLink); }
- 应用在后台运行时监听动态链接触发:
FirebaseDynamicLinks.instance.onLink.listen((dynamicLinkData) { handleDeepLink(dynamicLinkData.link); }).onError((error) { // 处理错误逻辑 });
- 你可以在动态链接的后缀拼接自定义参数,比如
https://xxx.page.link/operate?type=refresh&uid=123,收到链接后解析type参数判断要调用的函数,uid等作为参数传入即可。
测试阶段避坑提示
- iOS端如果是国内测试设备,要确保设备能正常访问Firebase服务,否则Associated Domains的校验会失败导致无法拉起
- 不要用模拟器测试动态链接拉起,优先用真机测试,模拟器的Associated Domains、DeepLink适配有很多已知问题
- 测试时可以先生成短链或者直接用长动态链接,直接在系统备忘录里点击链接测试即可,不要在微信/QQ等内置浏览器里点击,这类应用会拦截DeepLink跳转
内容的提问来源于stack exchange,提问作者tessu
相关产品推荐
相关产品推荐

