1. 插件介绍

fluttertpc_open_file 是一个专为鸿蒙系统适配的 Flutter 插件，基于 open_file 开发，提供了调用原生应用打开各种文件的能力。通过该插件，开发者可以轻松实现文件预览、打开外部应用等功能，支持多种文件类型，如文档、图片、音频、视频等，为应用提供了丰富的文件交互体验。

2. 安装与配置

2.1 添加依赖

由于这是针对鸿蒙系统的自定义修改版本，需要通过 Git 形式引入依赖。在项目的 pubspec.yaml 文件中添加以下配置：

dependencies:
  open_file:
    git:
      url: "https://gitcode.com/openharmony-sig/fluttertpc_open_file.git"

dev_dependencies:
  open_file_ohos:
    git:
      url: "https://gitcode.com/openharmony-sig/fluttertpc_open_file.git"
      path: ./ohos

添加依赖后，执行以下命令获取包：

flutter pub get

3. API 使用示例

3.1 导入包

在需要使用文件打开功能的 Dart 文件中导入包：

import 'package:open_file/open_file.dart';

3.2 打开文件

插件提供了简单直观的 API 来打开文件。以下是基本使用示例：

import 'package:open_file/open_file.dart';

// 打开指定路径的文件
OpenFile.open("/sdcard/example.txt");

3.3 指定文件类型

可以选择性地指定文件的 MIME 类型或统一类型标识符（UTI）来帮助系统选择合适的应用程序打开文件：

// 打开文本文件并指定 MIME 类型
OpenFile.open("/sdcard/example.txt", type: "text/plain");

// 打开 PDF 文件
OpenFile.open("/sdcard/document.pdf", type: "application/pdf");

// 打开图片文件并指定统一类型标识符
OpenFile.open("/sdcard/image.jpg", uti: "public.jpeg");

3.4 处理返回结果

OpenFile.open() 方法返回一个 Future<File> 对象，可以通过 then() 或 await 来处理打开结果：

// 使用 then() 处理结果
OpenFile.open("/sdcard/example.txt").then((result) {
  print("文件打开结果: ${result.message}");
  if (result.type == ResultType.done) {
    print("文件成功打开");
  } else if (result.type == ResultType.error) {
    print("文件打开失败: ${result.message}");
  }
});

// 使用 await 处理结果
Future<void> openDocument() async {
  final result = await OpenFile.open("/sdcard/document.pdf");
  print("打开结果: ${result.type} - ${result.message}");
}

4. 支持的文件类型

虽然鸿蒙平台会自动识别大多数常见文件类型，但插件内部支持多种文件格式的 MIME 类型映射，包括但不限于：

文档类

• .txt - 文本文件
• .pdf - PDF文档
• .doc, .docx - Word文档
• .xls, .xlsx - Excel表格
• .ppt, .pptx - PowerPoint演示文稿
• .rtf - RTF文档
• .html, .htm - HTML文件
• .xml - XML文件

图片类

• .jpg, .jpeg - JPEG图片
• .png - PNG图片
• .gif - GIF图片
• .bmp - BMP图片

音视频类

• .mp3 - MP3音频
• .wav - WAV音频
• .mp4 - MP4视频
• .avi - AVI视频
• .mov - MOV视频
• .mpeg, .mpg - MPEG视频

压缩包类

• .zip - ZIP压缩包
• .tar - TAR归档文件
• .gz, .tgz - GZIP压缩文件

5. 兼容性

在以下版本中已测试通过：

• Flutter: 3.7.12-ohos-1.1.3; SDK: 5.0.0(12); IDE: DevEco Studio: 5.1.0.828; ROM: 5.1.0.130 SP8;
• Flutter: 3.22.1-ohos-1.0.3; SDK: 5.0.0(12); IDE: DevEco Studio: 5.1.0.828; ROM: 5.1.0.130 SP8;

6. 注意事项

1. 文件路径：确保提供的文件路径是正确的，并且应用具有访问该文件的权限。

2. 文件权限：在鸿蒙系统中，如果需要访问外部存储中的文件，可能需要请求相应的存储权限。

3. 应用选择：如果系统中有多个应用可以打开同一种类型的文件，会显示应用选择对话框让用户选择。

4. 文件类型：虽然系统会尝试自动识别文件类型，但明确指定 MIME 类型可以提高打开成功率。

7. 总结

fluttertpc_open_file 插件为鸿蒙系统提供了便捷的文件打开功能，使开发者能够轻松实现各种文件交互场景。通过简单的 API 调用，即可调用系统原生应用打开几乎所有类型的文件，为应用提供了丰富的文件处理能力。

该插件具有良好的兼容性，支持多种 Flutter 和鸿蒙系统版本，并且使用方法与其他平台保持一致，降低了跨平台开发的学习成本。

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net