Flutter如何通过“打开方式”对话框打开TXT文件并跳转至指定页面？

Hey 兄弟！作为Flutter新手碰到intent filter这种原生相关的问题确实容易卡壳，我来一步步帮你搞定，让用户点击TXT文件就能直接打开你的App并跳转到内容页面，彻底替代之前繁琐的ImportFile插件操作～

首先得让系统知道你的App能处理TXT文件的打开请求，这一步要修改AndroidManifest.xml：

• 打开android/app/src/main/AndroidManifest.xml，找到你的主Activity（一般是MainActivity），在<activity>标签里添加下面的intent filter：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <!-- 匹配TXT文件的MIME类型，核心配置 -->
    <data android:mimeType="text/plain" />
    <!-- 兼容两种文件访问方式：本地文件和content provider提供的文件 -->
    <data android:scheme="file" />
    <data android:scheme="content" />
</intent-filter>

小提示：如果不想用户每次打开文件都启动新的App实例，可以给Activity加上android:launchMode="singleTop"，这样新的打开请求会递交给已运行的App实例处理。

接下来要在Flutter里获取系统传递过来的文件信息，这里推荐用receive_sharing_intent这个第三方包，它能帮我们轻松监听打开文件的请求：

1. 先在pubspec.yaml里添加依赖：

dependencies:
  flutter:
    sdk: flutter
  receive_sharing_intent: ^1.4.5 # 可以去pub.dev找最新版本

然后执行flutter pub get安装依赖。

2. 在你的主App组件里监听文件请求：

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

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

class _MyAppState extends State<MyApp> {
  StreamSubscription<List<SharedMediaFile>>? _intentSubscription;

  @override
  void initState() {
    super.initState();
    // 处理App启动时的文件请求（比如用户直接点击TXT打开App）
    _handleInitialFile();
    // 监听App运行中收到的文件打开请求
    _setupIntentListener();
  }

  void _handleInitialFile() async {
    final files = await ReceiveSharingIntent.getInitialMedia();
    if (files != null && files.isNotEmpty) {
      _navigateToFilePage(files.first.path);
    }
  }

  void _setupIntentListener() {
    _intentSubscription = ReceiveSharingIntent.getMediaStream().listen(
      (files) {
        if (files.isNotEmpty) {
          _navigateToFilePage(files.first.path);
        }
      },
      onError: (err) => print('处理文件请求出错：$err'),
    );
  }

  void _navigateToFilePage(String filePath) {
    // 跳转到你的文件内容展示页面，把文件路径传过去
    Navigator.push(
      context,
      MaterialPageRoute(
        builder: (context) => FileDisplayPage(filePath: filePath),
      ),
    );
  }

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(appBar: AppBar(title: Text('我的Flutter App'))),
    );
  }
}

3. 实现文件内容展示页面：

class FileDisplayPage extends StatefulWidget {
  final String filePath;

  const FileDisplayPage({Key? key, required this.filePath}) : super(key: key);

  @override
  _FileDisplayPageState createState() => _FileDisplayPageState();
}

class _FileDisplayPageState extends State<FileDisplayPage> {
  String _fileContent = '加载中...';

  @override
  void initState() {
    super.initState();
    _readFileContent();
  }

  Future<void> _readFileContent() async {
    try {
      // 注意：如果是Android的content URI，需要先转换成真实路径，下面会讲
      final content = await DefaultAssetBundle.of(context).loadString(widget.filePath);
      setState(() => _fileContent = content);
    } catch (e) {
      setState(() => _fileContent = '读取文件失败：$e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('文件内容')),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: SingleChildScrollView(child: Text(_fileContent)),
      ),
    );
  }
}

Android 10+很多文件是通过content URI传递的，直接用File类读取会失败，这时候可以用android_content_provider包来转换：

1. 添加依赖：

dependencies:
  android_content_provider: ^0.2.0

2. 修改_navigateToFilePage方法：

import 'package:android_content_provider/android_content_provider.dart';

void _navigateToFilePage(String fileUri) async {
  String? realPath;
  if (fileUri.startsWith('content://')) {
    realPath = await AndroidContentProvider.getFilePath(fileUri);
  } else {
    realPath = fileUri;
  }

  if (realPath != null) {
    Navigator.push(
      context,
      MaterialPageRoute(
        builder: (context) => FileDisplayPage(filePath: realPath),
      ),
    );
  } else {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('无法获取文件路径，请检查权限')),
    );
  }
}

如果你的App要上架iOS，也需要配置让系统识别它能处理TXT文件：

打开ios/Runner/Info.plist，添加下面的配置：

<key>CFBundleDocumentTypes</key>
<array>
  <dict>
    <key>CFBundleTypeName</key>
    <string>文本文件</string>
    <key>CFBundleTypeRole</key>
    <string>Viewer</string>
    <key>LSHandlerRank</key>
    <string>Alternate</string>
    <key>LSItemContentTypes</key>
    <array>
      <string>public.plain-text</string> <!-- TXT文件的统一类型标识符 -->
    </array>
  </dict>
</array>

iOS端的文件监听逻辑和Android完全一样，用receive_sharing_intent就能处理。

Android 10+需要读取外部存储的权限，在AndroidManifest.xml里添加：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /> <!-- 兼容Android 13+ -->

如果需要动态请求权限，可以用permission_handler包来实现。

这样配置完成后，用户点击TXT文件选择你的App，就能直接跳转到内容展示页面啦，操作比之前用ImportFile插件流畅太多！

内容的提问来源于stack exchange，提问作者max man