Flutter安卓分享处理插件 share_handler_android 的使用

share_handler_android 是 share_handler_platform_interface 包的实现，专为 Android 平台设计。该插件允许你在 Flutter 应用中处理来自其他应用的共享内容（如文本、图片等）。本文将详细介绍如何在你的 Flutter 项目中集成和使用这个插件。

使用方法

与 share_handler 插件一起使用

share_handler_android 是 share_handler 插件的官方实现之一，因此只需在项目的 pubspec.yaml 文件中添加 share_handler 依赖即可自动包含该插件。

步骤 1：添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  share_handler: ^0.2.0  # 确保使用最新版本

然后运行以下命令来安装依赖：

flutter pub get

步骤 2：配置 Android 清单文件

为了使应用能够接收共享数据，你需要在 AndroidManifest.xml 中声明一个 Intent Filter。打开 android/app/src/main/AndroidManifest.xml 文件，并在 <activity> 标签内添加如下代码：

<intent-filter>
    <action android:name="android.intent.action.SEND" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="text/plain" /> <!-- 根据需要调整 MIME 类型 -->
</intent-filter>

例如，如果你想支持文本和图片的共享，可以这样配置：

<intent-filter>
    <action android:name="android.intent.action.SEND" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="image/*" />
</intent-filter>
<intent-filter>
    <action android:name="android.intent.action.SEND" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="text/plain" />
</intent-filter>

步骤 3：处理共享数据

接下来，在 Dart 代码中监听共享的数据。你可以通过 ShareHandlerPlatform.instance 来获取当前平台的实现，并设置回调函数来处理共享的内容。

下面是一个简单的示例 Demo，展示了如何监听并处理共享的文本或图片：

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

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

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

class _MyAppState extends State<MyApp> {
  String _sharedText = 'No shared text received yet.';
  List<String> _sharedImages = [];

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化时注册回调函数
    ShareHandlerPlatform.instance.receivedShareStream.listen((event) {
      if (event.text != null) {
        setState(() {
          _sharedText = event.text!;
        });
      }
      if (event.files.isNotEmpty) {
        setState(() {
          _sharedImages = event.files.map((file) => file.path).toList();
        });
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Share Handler Demo'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text(_sharedText),
              if (_sharedImages.isNotEmpty)
                Expanded(
                  child: ListView.builder(
                    itemCount: _sharedImages.length,
                    itemBuilder: (context, index) {
                      return Image.file(File(_sharedImages[index]));
                    },
                  ),
                ),
            ],
          ),
        ),
      ),
    );
  }
}