Firebase动态链接打开层级页而非启动Flutter应用问题求助

Android Manifest配置检查 #

这是导致链接无法唤起应用的核心环节之一，重点核对以下几点：

1. 确保启动Activity的android:exported属性为true
   Android 12+要求可被外部唤起的Activity必须显式设置该属性，否则会被系统拦截：

<activity
    android:name=".MainActivity"
    android:exported="true">
    <!-- 主入口intent-filter -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity>

2. 添加正确的动态链接处理intent-filter
   必须包含VIEW动作、BROWSABLE类别，且data节点匹配你的动态链接域名（如xxx.page.link或自定义域名）：

<activity android:name=".MainActivity" android:exported="true">
    <!-- 原有主入口intent-filter -->
    <intent-filter>...</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"/>
        <!-- 替换为你的Firebase动态链接域名 -->
        <data android:scheme="https" android:host="your-domain.page.link"/>
        <!-- 如果使用自定义scheme，也需添加 -->
        <data android:scheme="yourapp" android:host="deeplink"/>
    </intent-filter>
</activity>

动态链接创建代码校验 #

检查Flutter端创建链接的参数是否完整，尤其是Android端的包名配置：

final dynamicLinkParams = DynamicLinkParameters(
  // 应用内要处理的深链接
  link: Uri.parse('https://your-app.com/product/123'),
  // Firebase动态链接前缀（需在控制台配置）
  uriPrefix: 'https://your-domain.page.link',
  androidParameters: AndroidParameters(
    // 必须与AndroidManifest中的applicationId完全一致，大小写敏感
    packageName: 'com.your.app.package',
    minimumVersion: 1, // 可选：最低支持的应用版本
  ),
);

final shortLink = await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);
final shareUrl = shortLink.shortUrl.toString();

核心注意点：packageName必须和Android项目的applicationId完全匹配，任何拼写错误都会导致链接无法定位到应用。

Firebase控制台配置核对 #

1. 确认SHA指纹已正确配置
   进入Firebase控制台 → 你的项目 → 应用设置 → Android应用，检查SHA-1和SHA-256指纹是否已添加。缺失指纹会导致App Links域名验证失败，链接只能打开网页而非应用。
2. 验证授权域名
   在动态链接设置页面，确认你的基础URL（如your-domain.page.link或自定义域名）已加入“授权域名”列表。
3. 检查链接行为默认设置
   创建动态链接时，确保“链接行为”选择了“打开应用”而非“打开网页”，避免强制跳转至网页。

应用内动态链接监听逻辑 #

即使链接能唤起应用，若无监听逻辑也无法处理深链接，建议在main函数中初始化监听：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  // 处理启动时的初始链接
  final initialLink = await FirebaseDynamicLinks.instance.getInitialLink();
  if (initialLink != null) {
    _handleDeepLink(initialLink.link);
  }

  // 监听应用运行时的动态链接
  FirebaseDynamicLinks.instance.onLink.listen((data) {
    _handleDeepLink(data.link);
  });

  runApp(const MyApp());
}

void _handleDeepLink(Uri link) {
  // 根据深链接路径跳转对应页面，例如：
  if (link.pathSegments.contains('product')) {
    final productId = link.pathSegments.last;
    // 导航到商品详情页
  }
}

测试注意事项 #

• 务必使用真实设备测试，模拟器可能无法正确解析App Links；
• 不要直接在浏览器中输入链接，通过短信、社交软件分享后点击，或用adb命令测试：

  adb shell am start -W -a android.intent.action.VIEW -d "https://your-dynamic-link-url"
  

• 测试前清除应用缓存和浏览器缓存，避免旧配置干扰；
• 若使用自定义域名，需验证/.well-known/assetlinks.json文件可访问，内容需包含应用包名和SHA-256指纹。

内容的提问来源于stack exchange，提问作者Ali Alqallaf