Flutter中处理外部应用传入Intent及配置Intent Filter打开PDF文件夹的方法

针对Android平台（你的问题提到了Manifest，以下重点讲解Android实现），需要结合原生代码与Flutter通道完成，具体步骤如下：

1. 配置AndroidManifest.xml的Intent Filter #

在主Activity标签内添加对应Intent Filter，以接收打开PDF文件的请求为例：

<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:mimeType="application/pdf" />
</intent-filter>

2. 原生层传递Intent数据到Flutter #

修改MainActivity.kt（Java版逻辑一致），重写生命周期方法获取Intent，并通过MethodChannel将数据传递给Flutter：

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel
import android.content.Intent
import android.net.Uri

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.your.package/intent_handler"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "getInitialIntent") {
                val uri = intent.data?.toString()
                result.success(uri)
            }
        }
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        val uri = intent.data?.toString()
        flutterEngine?.let {
            MethodChannel(it.dartExecutor.binaryMessenger, CHANNEL)
                .invokeMethod("onNewIntentReceived", uri)
        }
    }
}

3. Flutter端监听并处理Intent数据 #

在Flutter代码中，通过MethodChannel接收初始Intent与后续的Intent请求：

import 'package:flutter/services.dart';

class ExternalIntentHandler {
  static const _channel = MethodChannel('com.your.package/intent_handler');
  static Function(String?)? onNewIntent;

  static Future<String?> getInitialIntent() async {
    try {
      return await _channel.invokeMethod('getInitialIntent');
    } on PlatformException catch (_) {
      return null;
    }
  }

  static void setupListener() {
    _channel.setMethodCallHandler((call) async {
      if (call.method == 'onNewIntentReceived') {
        final uri = call.arguments as String?;
        onNewIntent?.call(uri);
      }
    });
  }
}

// 在main函数初始化监听
void main() {
  WidgetsFlutterBinding.ensureInitialized();
  ExternalIntentHandler.setupListener();
  runApp(const MyApp());
}

// 在页面中处理Intent
class _MyHomePageState extends State<MyHomePage> {
  @override
  void initState() {
    super.initState();
    _handleInitialIntent();
    ExternalIntentHandler.onNewIntent = _handleNewIntent;
  }

  void _handleInitialIntent() async {
    final uri = await ExternalIntentHandler.getInitialIntent();
    if (uri != null) {
      // 调用PDF插件打开文件，例如flutter_pdfview或open_file
      // OpenFile.open(uri);
    }
  }

  void _handleNewIntent(String? uri) {
    if (uri != null) {
      // 处理新的PDF打开请求
    }
  }
}

要实现不启动主应用UI的效果，需创建透明原生Activity专门处理文件夹请求，完成后立即关闭。

1. 注册透明Activity到Manifest #

在AndroidManifest.xml中添加该Activity，设置透明主题并配置Intent Filter：

<activity
    android:name=".PdfFolderHandlerActivity"
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <!-- 指定文件夹MIME类型 -->
        <data android:mimeType="vnd.android.document/directory" />
        <!-- 可选：限定特定文件夹路径 -->
        <!-- <data android:path="/storage/emulated/0/MyPDFs" /> -->
    </intent-filter>
</activity>

2. 实现透明Activity的逻辑 #

创建PdfFolderHandlerActivity.kt，接收Intent并调用系统文件管理器打开文件夹，随后立即结束自身：

import android.app.Activity
import android.content.Intent
import android.net.Uri
import android.os.Bundle

class PdfFolderHandlerActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val folderUri = intent.data

        folderUri?.let {
            // 调用系统文件管理器打开目标文件夹
            val openFolderIntent = Intent(Intent.ACTION_VIEW).apply {
                data = it
                flags = Intent.FLAG_ACTIVITY_NEW_TASK
            }
            startActivity(openFolderIntent)
        }
        // 立即关闭，不显示任何界面
        finish()
    }
}

3. 验证测试 #

可用ADB命令模拟外部应用的Intent请求：

adb shell am start -a android.intent.action.VIEW -d "content://com.android.externalstorage.documents/tree/primary%3AMyPDFs" com.your.package

此时你的应用不会打开主界面，直接触发系统文件管理器打开指定的PDF文件夹。

内容的提问来源于stack exchange，提问作者Fachri Erlangga