Flutter通用链接处理插件ulink的使用

在Flutter开发中，处理通用链接（Universal Links）是一项常见的需求。本文将介绍如何使用uLink插件来实现这一功能，并提供一个完整的示例代码。

uLink简介

uLink 是一个用于处理通用链接的Flutter插件，特别适用于与物联网设备进行通信。它可以帮助开发者轻松地处理来自外部的链接请求，并将其解析为相应的操作。

使用步骤

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

添加依赖
在pubspec.yaml文件中添加uLink插件依赖：
```
dependencies:
  ulink: ^1.0.0
```
初始化插件
在应用程序启动时初始化uLink插件。
监听链接事件
监听来自外部的链接请求，并根据链接内容执行相应操作。

完整示例代码

以下是一个完整的示例代码，展示如何使用uLink插件处理通用链接：

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MyHomePage(),
    );
  }
}

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

class _MyHomePageState extends State<MyHomePage> {
  String _linkContent = "未接收到链接";

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化uLink插件
    ULink.initialize(onLinkReceived: (String link) {
      setState(() {
        _linkContent = "接收到链接: $link";
      });
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("uLink示例"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(
              "当前链接内容:",
              style: TextStyle(fontSize: 18),
            ),
            SizedBox(height: 10),
            Text(
              _linkContent,
              style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),
            ),
          ],
        ),
      ),
    );
  }
}

songsunli 1楼•11 天前

更多关于Flutter通用链接处理插件ulink的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

在Flutter中，处理通用链接（Universal Links）和深度链接（Deep Links）是一个常见的需求。ulink 是一个Flutter插件，用于简化通用链接和深度链接的处理。以下是如何使用 ulink 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 ulink 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  ulink: ^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>com.example.app</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="www.example.com" />
</intent-filter>

3. 使用 `ulink` 插件

初始化

在你的Flutter应用中初始化 ulink 插件：

import 'package:ulink/ulink.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ULink.init();
  runApp(MyApp());
}

监听链接

你可以使用 ULink 来监听应用启动时的链接，或者在应用运行时接收链接：

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('ULink Example'),
        ),
        body: Center(
          child: StreamBuilder<Uri>(
            stream: ULink.onLink,
            builder: (context, snapshot) {
              if (snapshot.hasData) {
                return Text('Received link: ${snapshot.data}');
              } else {
                return Text('No link received');
              }
            },
          ),
        ),
      ),
    );
  }
}

处理链接

你可以在 StreamBuilder 中处理接收到的链接，并根据链接的内容进行导航或其他操作。

StreamBuilder<Uri>(
  stream: ULink.onLink,
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      Uri link = snapshot.data;
      // 根据链接内容进行导航
      if (link.path == '/profile') {
        return ProfilePage();
      } else if (link.path == '/settings') {
        return SettingsPage();
      } else {
        return HomePage();
      }
    } else {
      return HomePage();
    }
  },
)

4. 测试链接

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

iOS: 在Safari中输入 https://www.example.com/profile，然后点击打开应用。
Android: 在浏览器中输入 https://www.example.com/profile，然后点击打开应用。

5. 处理冷启动和热启动

ulink 插件会自动处理冷启动（应用未运行时点击链接）和热启动（应用已运行时点击链接）的情况。

6. 处理错误

你可以通过 ULink.onError 流来监听和处理错误：

ULink.onError.listen((error) {
  print('Error: $error');
});

7. 清理

在应用退出时，你可以选择清理 ulink 的资源：

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