Flutter应用链接管理插件app_links_module的使用

在Flutter中，app_links 是一个常用的插件，用于处理深度链接（Deep Links）和通用链接（Universal Links）。它允许你在应用中处理来自外部链接的导航，例如用户点击了一个链接并希望跳转到应用的特定页面。

app_links 插件的主要功能包括：

1. 处理深度链接：允许应用通过自定义的 URL 方案（如 myapp://）打开特定页面。
2. 处理通用链接：允许应用通过标准的 HTTP/HTTPS 链接（如 https://example.com）打开特定页面。

安装 app_links 插件

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

dependencies:
  flutter:
    sdk: flutter
  app_links: ^2.0.0

然后，运行 flutter pub get 来安装依赖。

配置 Android 和 iOS

Android 配置

在 android/app/src/main/AndroidManifest.xml 文件中，添加 <intent-filter> 来处理深度链接和通用链接：

<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 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="example.com" />
        <data android:scheme="http" android:host="example.com" />
    </intent-filter>
</activity>

iOS 配置

在 ios/Runner/Info.plist 文件中，添加以下内容来处理通用链接：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>com.example.app</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>
<key>FlutterDeepLinkingEnabled</key>
<true/>

使用 app_links 插件

在 Flutter 代码中，你可以使用 app_links 插件来监听和处理链接。

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  final appLinks = AppLinks();

  // Listen to link updates
  appLinks.uriLinkStream.listen((uri) {
    // Handle the link
    print('App opened with link: $uri');
    // You can navigate to a specific page based on the link
  });

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'App Links Example',
      home: Scaffold(
        appBar: AppBar(
          title: Text('App Links Example'),
        ),
        body: Center(
          child: Text('Welcome to the App Links Example!'),
        ),
      ),
    );
  }
}

处理链接

在 appLinks.uriLinkStream.listen 中，你可以根据 uri 的值来决定导航到哪个页面。例如：

appLinks.uriLinkStream.listen((uri) {
  if (uri.path == '/profile') {
    Navigator.pushNamed(context, '/profile');
  } else if (uri.path == '/settings') {
    Navigator.pushNamed(context, '/settings');
  }
});

获取初始链接

你还可以通过 appLinks.getInitialAppLink 来获取应用启动时的初始链接：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  final appLinks = AppLinks();

  // Get the initial link
  final initialUri = await appLinks.getInitialAppLink();
  if (initialUri != null) {
    print('App opened with initial link: $initialUri');
    // Handle the initial link
  }

  // Listen to link updates
  appLinks.uriLinkStream.listen((uri) {
    print('App opened with link: $uri');
    // Handle the link
  });

  runApp(MyApp());
}