Flutter统一链接处理插件uni_links3的使用

简介

uni_links 是一个Flutter插件项目，用于处理App/Deep Links（Android）和Universal Links及Custom URL schemes（iOS）。这些链接类似于网页浏览器中的链接，可以激活您的应用程序，并可能包含您用来加载特定部分或继续某些用户活动的信息。

安装

添加依赖

在 pubspec.yaml 文件中添加 uni_links 依赖：

dependencies:
  flutter:
    sdk: flutter
  uni_links: ^0.5.1

权限配置

Android

在 android/app/src/main/AndroidManifest.xml 中声明意图过滤器：

Deep Links

<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="[YOUR_SCHEME]" android:host="[YOUR_HOST]" />
</intent-filter>

App Links

<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="[YOUR_HOST]" />
</intent-filter>

iOS

在 ios/Runner/Info.plist 中声明URL类型：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLName</key>
        <string>[ANY_URL_NAME]</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>[YOUR_SCHEME]</string>
        </array>
    </dict>
</array>

或者通过Xcode设置关联域：

1. 打开 ios/Runner.xcworkspace。
2. 在项目导航器中选择 Runner 根项。
3. 选择 Signing & Capabilities 选项卡，点击 + Capability 按钮。
4. 添加 Associated Domains 并输入你的域名，如 applinks:[YOUR_HOST]。

使用示例

初始化链接处理

在应用启动时初始化链接处理：

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

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  Uri? _initialUri;
  Uri? _latestUri;
  Object? _err;

  StreamSubscription? _sub;

  @override
  void initState() {
    super.initState();
    _handleIncomingLinks();
    _handleInitialUri();
  }

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

  void _handleIncomingLinks() {
    if (!kIsWeb) {
      _sub = uriLinkStream.listen((Uri? uri) {
        if (!mounted) return;
        setState(() {
          _latestUri = uri;
          _err = null;
        });
      }, onError: (Object err) {
        if (!mounted) return;
        setState(() {
          _latestUri = null;
          if (err is FormatException) {
            _err = err;
          } else {
            _err = null;
          }
        });
      });
    }
  }

  Future<void> _handleInitialUri() async {
    try {
      final uri = await getInitialUri();
      if (uri == null) {
        print('no initial uri');
      } else {
        print('got initial uri: $uri');
      }
      if (!mounted) return;
      setState(() => _initialUri = uri);
    } on PlatformException {
      print('falied to get initial uri');
    } on FormatException catch (err) {
      if (!mounted) return;
      setState(() => _err = err);
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('uni_links example app')),
        body: ListView(
          children: [
            ListTile(
              title: const Text('Initial Uri'),
              subtitle: Text('$_initialUri'),
            ),
            ListTile(
              title: const Text('Latest Uri'),
              subtitle: Text('$_latestUri'),
            ),
          ],
        ),
      ),
    );
  }
}

测试链接

在终端中运行以下命令来测试链接：

• Android:

  adb shell 'am start -W -a android.intent.action.VIEW -c android.intent.category.BROWSABLE -d "unilinks://host/path/subpath"'
  

• iOS:

  /usr/bin/xcrun simctl openurl booted "unilinks://host/path/subpath"