app_links_lego 是一个用于 Flutter 应用程序的插件，用于处理深度链接（Deep Links）和通用链接（Universal Links）。它可以帮助你管理应用程序的链接，使得用户点击链接时能够直接打开你的应用程序，并跳转到特定的页面。

以下是使用 app_links_lego 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 app_links_lego 依赖：

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

然后运行 flutter pub get 来获取依赖。

2. 配置 iOS 和 Android

iOS 配置

在 ios/Runner/Info.plist 文件中添加以下内容以支持通用链接：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLName</key>
        <string>your.bundle.id</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>yourapp</string>
        </array>
    </dict>
</array>
<key>FlutterDeepLinkingEnabled</key>
<true/>

Android 配置

在 android/app/src/main/AndroidManifest.xml 文件中添加以下内容以支持深度链接：

<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>

3. 初始化插件

在你的 Flutter 应用程序的 main.dart 文件中初始化 app_links_lego：

import 'package:app_links_lego/app_links_lego.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 AppLinks
  final appLinks = AppLinks();
  
  runApp(MyApp(appLinks: appLinks));
}

class MyApp extends StatelessWidget {
  final AppLinks appLinks;

  MyApp({required this.appLinks});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(appLinks: appLinks),
    );
  }
}

4. 处理链接

在 MyHomePage 或其他页面中处理链接：

class MyHomePage extends StatefulWidget {
  final AppLinks appLinks;

  MyHomePage({required this.appLinks});

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  late StreamSubscription<Uri> _linkSubscription;

  [@override](/user/override)
  void initState() {
    super.initState();

    // 监听链接
    _linkSubscription = widget.appLinks.uriLinkStream.listen((uri) {
      // 处理链接
      print('Received link: $uri');
      // 你可以在这里根据 uri 进行页面跳转或其他操作
    });
  }

  [@override](/user/override)
  void dispose() {
    _linkSubscription.cancel();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Demo Home Page'),
      ),
      body: Center(
        child: Text('Hello, World!'),
      ),
    );
  }
}

5. 测试链接

你可以通过以下方式测试链接：

• iOS: 使用 Safari 浏览器访问你的通用链接，例如 https://yourdomain.com/path。
• Android: 使用 Chrome 浏览器访问你的深度链接，例如 https://yourdomain.com/path。

如果一切配置正确，点击链接应该会直接打开你的应用程序，并触发 uriLinkStream 事件。

6. 处理冷启动和热启动

app_links_lego 也会处理应用程序在冷启动和热启动时的链接。你可以在 initState 中通过 widget.appLinks.getInitialLink() 获取初始链接。

[@override](/user/override)
void initState() {
  super.initState();

  // 获取初始链接
  widget.appLinks.getInitialLink().then((uri) {
    if (uri != null) {
      print('Initial link: $uri');
      // 处理初始链接
    }
  });

  // 监听链接
  _linkSubscription = widget.appLinks.uriLinkStream.listen((uri) {
    print('Received link: $uri');
  });
}