基于Flutter的社交应用：首次安装后检测邀请URL实现自动推荐验证的跨平台技术问询

绝对有可行的方案！我之前在类似的社交应用项目里落地过这个功能，核心是靠应用链接（Android）和通用链接（iOS），再配合Flutter的深层链接处理能力，就能实现用户安装后首次打开自动识别邀请关系，完全不用手动输入推荐码。下面分平台和Flutter端给你一步步拆解：

用户点击的邀请链接会携带推荐标识（比如 https://yourdomain.com/invite?referrer=user123 里的 user123），当用户通过这个链接跳转应用商店安装后，首次打开应用时，系统会把原始的邀请链接传递给应用。我们只需要在Flutter里解析这个链接、提取推荐标识，就能自动调用后端接口绑定推荐关系。

• 第一步：在你的域名下配置验证文件，放在 .well-known 目录下，命名为 assetlinks.json，用来证明你的应用和域名的归属关系。示例内容如下：

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.your.app.package",
    "sha256_cert_fingerprints": ["你的应用签名SHA256指纹"]
  }
}]

• 第二步：在 AndroidManifest.xml 里添加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" />
    <data android:scheme="https" android:host="yourdomain.com" />
</intent-filter>

• 额外 fallback：如果担心App Links偶尔失效（比如用户通过短信跳转Play商店的场景），可以集成Google的安装引荐API，用 install_referrer 插件在Flutter里调用，获取安装时的引荐参数。

• 第一步：在Apple开发者后台，给你的应用开启「Associated Domains」权限，添加 applinks:yourdomain.com。
• 第二步：在你的域名根目录或 .well-known 目录下配置 apple-app-site-association 文件（无后缀），示例内容：

{
  "applinks": {
    "apps": [],
    "details": [{
      "appID": "你的TeamID.com.your.app.package",
      "paths": ["/*"]
    }]
  }
}

• 第三步：在Xcode项目配置的「Signing & Capabilities」里，添加「Associated Domains」，填入 applinks:yourdomain.com。

iOS的Universal Links会在应用安装后自动完成关联，用户打开邀请链接时，若应用已安装则直接跳转并传递链接；若未安装则跳转App Store，安装后首次打开时，系统会自动把原始邀请链接传递给应用。

推荐使用 uni_links 插件，它同时支持Android和iOS，用法简洁：

1. 先在 pubspec.yaml 添加依赖：

dependencies:
  uni_links: ^0.5.1

2. 在应用初始化时监听首次打开的链接：

import 'package:uni_links/uni_links.dart';
import 'package:flutter/services.dart';
import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 处理首次启动的深层链接
  try {
    final initialLink = await getInitialLink();
    if (initialLink != null) {
      _handleReferrerLink(initialLink);
    }
  } on PlatformException catch (e) {
    print('解析链接出错: ${e.message}');
  }
  
  runApp(const MyApp());
}

void _handleReferrerLink(String link) {
  final uri = Uri.parse(link);
  final referrerCode = uri.queryParameters['referrer'];
  if (referrerCode != null) {
    // 调用后端API绑定推荐关系
    _bindReferrerToCurrentUser(referrerCode);
  }
}

// 模拟绑定推荐关系的后端调用
Future<void> _bindReferrerToCurrentUser(String referrerCode) async {
  // 示例：await http.post(
  //   'https://yourdomain.com/api/bind-referrer',
  //   body: {'referrer_code': referrerCode}
  // );
}

3. 额外处理应用在前台时的链接跳转（比如用户已打开应用，再点击邀请链接的场景）：

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  StreamSubscription? _linkSubscription;

  @override
  void initState() {
    super.initState();
    _listenToLinkStream();
  }

  void _listenToLinkStream() {
    _linkSubscription = linkStream.listen((String? link) {
      if (link != null) {
        _handleReferrerLink(link);
      }
    }, onError: (err) {
      print('监听链接出错: $err');
    });
  }

  @override
  void dispose() {
    _linkSubscription?.cancel();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return const Scaffold(
      body: Center(child: Text('你的应用首页')),
    );
  }
}

• Android测试时，要用正式签名的APK（或者把debug签名的SHA256指纹添加到 assetlinks.json），否则App Links的自动验证会失败。
• iOS可以用Apple官方的验证工具检查 apple-app-site-association 文件是否配置正确。
• 部分第三方应用（如微信）可能会拦截Universal Links/App Links，这时候可以做一个中转网页，提示用户「打开应用」或「前往应用商店」，同时把推荐码存在本地存储或通过其他方式传递。
• 一定要处理链接解析的异常情况（比如链接格式错误、无推荐参数），避免应用崩溃。

内容的提问来源于stack exchange，提问作者Shashi kumar S