Flutter接收第三方应用分享

Aengus Sun 958 2020-01-13

这里接收第三方应用分享是指本应用接收第三方应用分享的文件,如长按文件选择分享,本应用显示在分享列表中,点击后本应用接收并处理文件内容。

Flutter并没有相似的原生代码功能,所以我们需要使用安卓原生的代码进行接收,然后再调用Flutter代码对文件内容进行处理。Flutter与安卓原生代码之间的互相调用可以看这篇博客

步骤

注册为接收分享应用

首先需要在AndroidManifest.xml中添加activity

<activity android:name=".ReceiveShareActivity" android:label="导入测试">
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/*" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.SEND_MULTIPLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/*" />
    </intent-filter>
</activity>
  1. 其中android:name代表接收文件处理类的名称,.ReceiveShareActivity代表是在根目录下的ReceiveShareActivity类文件;

  2. android:label代表提示信息,也就是分享列表中本应用显示的名称,如QQ“分享到好友”;

  3. <action android:name="android.intent.action.SEND" />则代表接收分享行为的类型,SEND代表接收单文件,SEND_MULTIPLE代表接收多文件;

  4. android:mimeType代表是接收文件的类型;

效果如下:

分享列表展示

编写安卓端代码

这里给出安卓端Kotlin的代码。

安卓端用于处理接收第三方应用分享的类需要继承FlutterActivity,且名称要与上面在AndroidManifest.xml中注册的名称一致。

读取文件内容这块有一些坑,我们在代码下面进行说明。

import android.Manifest.permission.READ_EXTERNAL_STORAGE
import android.Manifest.permission.WRITE_EXTERNAL_STORAGE
import android.content.Intent
import android.content.pm.PackageManager
import android.net.Uri
import android.os.Bundle
import android.util.Log
import android.widget.Toast
import androidx.core.app.ActivityCompat

import io.flutter.app.FlutterActivity
import io.flutter.plugin.common.MethodCall
import io.flutter.plugin.common.MethodChannel
import io.flutter.plugins.GeneratedPluginRegistrant

class ReceiveShareActivity : FlutterActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 安卓代码正常运行需要注册
        GeneratedPluginRegistrant.registerWith(this)
        val intent: Intent = intent
        val action: String? = intent.action
        val type: String = if (intent.type != null) intent.type!! else "unknown"
        // 判断Intent action,如果是SEND则调用下列代码,还有一个类型为ACTION_SEND_MULTIPLE
        if (Intent.ACTION_SEND == (action)) {
            // 如果是text类型
            if (type.startsWith("text/")) {
                val fileContent = processIntent(intent)
                // 调用Flutter方法对接收的文件内容进行处理
                MethodChannel(flutterView, "flutter.example.com/native").invokeMethod("handleText", fileContent)
            }
        }
    }

    private fun processIntent(intent: Intent): String {
        // 这个会在下面进行解释
        val uri: Uri? = intent.getParcelableExtra(Intent.EXTRA_STREAM)
        // 进行权限请求
        val permission = ActivityCompat.checkSelfPermission(
                this,
                READ_EXTERNAL_STORAGE
        )
        val permissionStorage: Array<String> = arrayOf(READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE)
        if (permission != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(
                    this,
                    permissionStorage,
                    1
            )
        }
        // 获取Intent中携带的数据
        val resolver = this.contentResolver
        if (uri != null) {
            resolver.openInputStream(uri).use {
                val reader = it?.reader()
                val fileContent = reader?.readText()
                return fileContent?:""
            }
        } else {
            Toast.makeText(this, "导入空文件!", Toast.LENGTH_SHORT).show()
            return ""
        }
    }
}

在上面的processIntent()函数中,即使文件内容不为空,如果使用下列语句会得到null。具体原因还不清楚。

val string: String = intent.getStringExtra(Intent.EXTRA_TEXT)

使用

 val uri: Uri? = intent.getParcelableExtra(Intent.EXTRA_STREAM)

会得到一个文件的Uri,但是由于此Uri是安卓系统中相对路径,如果在手机存储根目录下创建new.txt,打印此Uri.toString()则会输出

content://com.android.externalstorage.documents/document/primary%3Anew.txt

打印uri!!.path则会输出

/document/primary:new.txt

因此无法使用java.io.File获取一个File对象再进行读取操作。此外由于Environment.getExternalStorageDirectory()方法在安卓10中被弃用,而且目前大多数手机处理内置存储外,还可以插入一个SD卡,所以使用地址拼接的方式也不可行。

使用代码val resolver = this.contentResolver会得到一个解析器,再调用resolver.openInputStream(uri).use便可以对文件的数据进行读取了。

编写Flutter端代码

在上面的代码中,我们利用MethodChannel调用了Flutter端的名为handleText(String text)的代码,并将文件内容fileContent作为参数传到方法中,下面我们编写Flutter端代码,来处理此文件内容。

static const platform = const MethodChannel("flutter.example.com/native");
// ...
platform.setMethodCallHandler((call) {
  if (call.method == "handleText") {
    // call.arguments即为安卓端传进来的参数fileContent
    Future<Null> res = handleText(call.arguments);
    return res;
  } else {
    return null;
  }
});

需要注意的是Flutter端执行的方法与安卓端的invokeMethod是异步执行的,安卓端调用了Flutter端的方法后,会立刻执行其后面的语句,而不会等待Flutter端的方法执行完再执行后面的语句,这点从Flutter端setMethodeCallHandlerreturn Future<dynamic>也可以看出来。

这样我们就完成了Flutter应用接收第三方分享的功能,在用户点击分享选择我们的应用后,我们应用便启动ReceiveShareActivity,获取到其中的内容后再调用Flutter端处理的代码对文件进行处理。

参考

Android 接收其他应用的分享