sa_app_links_listener_lego 是一个用于监听和处理应用程序链接的 Flutter 插件。它可以帮助你在 Flutter 应用中处理深度链接（Deep Links）和通用链接（Universal Links）。以下是使用 sa_app_links_listener_lego 插件的基本步骤：

1. 添加依赖

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

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

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

2. 初始化插件

在你的 Flutter 应用中初始化 sa_app_links_listener_lego 插件。通常，你可以在 main.dart 文件中进行初始化。

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化插件
  await SaAppLinksListenerLego.initialize();

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Deep Link Example',
      home: HomeScreen(),
    );
  }
}

3. 监听链接

在需要监听链接的地方，使用 SaAppLinksListenerLego 来监听链接事件。你可以在 initState 方法中设置监听器。

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

class HomeScreen extends StatefulWidget {
  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  String? _link;

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

  void _listenForLinks() {
    SaAppLinksListenerLego.listen((String link) {
      setState(() {
        _link = link;
      });
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Deep Link Example'),
      ),
      body: Center(
        child: _link != null
            ? Text('Received link: $_link')
            : Text('No link received yet.'),
      ),
    );
  }
}

4. 处理链接

当应用接收到链接时，SaAppLinksListenerLego.listen 回调会被触发，你可以在回调中处理链接。例如，你可以根据链接的内容导航到不同的页面。

5. 配置深度链接（可选）

如果你需要处理深度链接或通用链接，你还需要在 Android 和 iOS 项目中进行相应的配置。

Android 配置

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

iOS 配置

在 Info.plist 文件中添加以下内容：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLName</key>
        <string>yourdomain.com</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>https</string>
        </array>
    </dict>
</array>

6. 测试链接

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

• Android: 使用 adb 命令发送深度链接：

  adb shell am start -W -a android.intent.action.VIEW -d "https://yourdomain.com/path" com.example.app

• iOS: 在 Safari 浏览器中直接输入链接，或者使用 Xcode 的模拟器测试。

7. 处理冷启动和热启动

sa_app_links_listener_lego 插件通常会处理冷启动和热启动的链接。确保你的应用在冷启动时也能正确处理链接。

8. 清理资源（可选）

如果你不再需要监听链接，可以调用 SaAppLinksListenerLego.dispose() 来释放资源。

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