flutter_facebook_deeplinks 是一个 Flutter 插件，用于处理 Facebook 的深度链接（Deep Links）。它可以帮助你在应用中处理来自 Facebook 的深度链接，以便在用户点击 Facebook 广告或帖子时，能够直接跳转到应用中的特定页面。

安装插件

首先，你需要在 pubspec.yaml 文件中添加 flutter_facebook_deeplinks 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_facebook_deeplinks: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装插件。

配置 Facebook App Links

在 Facebook 开发者平台上，你需要为你的应用配置 App Links。具体步骤如下：

1. 登录 Facebook 开发者平台。
2. 选择你的应用。
3. 在左侧菜单中选择 “App Links”。
4. 添加你的应用的 App Links URL，并配置相应的路径和参数。

在 Flutter 中使用 flutter_facebook_deeplinks

1. 初始化插件

在你的 main.dart 文件中，初始化 flutter_facebook_deeplinks 插件：

import 'package:flutter/material.dart';
import 'package:flutter_facebook_deeplinks/flutter_facebook_deeplinks.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 Facebook Deep Links
  await FlutterFacebookDeepLinks.init();
  
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Facebook Deep Links',
      home: HomeScreen(),
    );
  }
}

2. 处理深度链接

在你的应用启动时，你可以检查是否有来自 Facebook 的深度链接，并根据链接跳转到相应的页面。

class HomeScreen extends StatefulWidget {
  @override
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  String _deepLinkData = 'No deep link data';

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

  Future<void> _checkDeepLink() async {
    final deepLinkData = await FlutterFacebookDeepLinks.getDeepLink();
    if (deepLinkData != null) {
      setState(() {
        _deepLinkData = deepLinkData.toString();
      });
      // 根据 deepLinkData 跳转到相应的页面
      _navigateToPage(deepLinkData);
    }
  }

  void _navigateToPage(Map<String, dynamic> deepLinkData) {
    // 根据 deepLinkData 中的参数跳转到相应的页面
    // 例如：
    // if (deepLinkData['path'] == '/product') {
    //   Navigator.push(context, MaterialPageRoute(builder: (context) => ProductPage(id: deepLinkData['id'])));
    // }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Facebook Deep Links'),
      ),
      body: Center(
        child: Text(_deepLinkData),
      ),
    );
  }
}

3. 监听深度链接

你还可以监听深度链接的变化，以便在应用运行时处理新的深度链接。

@override
void initState() {
  super.initState();
  _checkDeepLink();
  
  // 监听深度链接的变化
  FlutterFacebookDeepLinks.onDeepLink.listen((deepLinkData) {
    setState(() {
      _deepLinkData = deepLinkData.toString();
    });
    _navigateToPage(deepLinkData);
  });
}

处理 iOS 和 Android 的配置

iOS 配置

在 ios/Runner/Info.plist 文件中，添加以下配置以支持 Facebook 的深度链接：

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>fb{your-app-id}</string>
    </array>
  </dict>
</array>
<key>FacebookAppID</key>
<string>{your-app-id}</string>
<key>FacebookDisplayName</key>
<string>{your-app-name}</string>
<key>LSApplicationQueriesSchemes</key>
<array>
  <string>fbapi</string>
  <string>fb-messenger-share-api</string>
  <string>fbauth2</string>
  <string>fbshareextension</string>
</array>

Android 配置

在 android/app/src/main/AndroidManifest.xml 文件中，添加以下配置以支持 Facebook 的深度链接：

<application
    android:label="your_app_name"
    android:icon="@mipmap/ic_launcher">
    
    <meta-data
        android:name="com.facebook.sdk.ApplicationId"
        android:value="@string/facebook_app_id" />
        
    <activity
        android:name=".MainActivity"
        android:launchMode="singleTop"
        android:theme="@style/LaunchTheme"
        android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|screenLayout|density|uiMode"
        android:hardwareAccelerated="true"
        android:windowSoftInputMode="adjustResize">
        
        <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="https" android:host="your-domain.com" />
        </intent-filter>
    </activity>
</application>