Flutter文档文本展示插件doc_text的使用

描述

doc_text 是一个Flutter插件，用于从Word文档（.doc 或 .docx）中提取纯文本字符串。该插件支持在Android和iOS平台上读取Word文档中的文本，使您能够更轻松地将文档处理功能集成到Flutter应用程序中。

设置

Android

要在Android上使用此插件，需要确保项目的 minSdkVersion 设置为26或更高，因为用于读取Word文档的依赖项需要此版本。

打开您的Android项目的 build.gradle 文件，位于 your_project/android/app/build.gradle，并将 minSdkVersion 更新为26：

android {
    ...

    defaultConfig {
        ...
        minSdkVersion 26
        ...
    }
}

iOS

由于iOS对 .doc 和 .docx 格式的支持有限，因此此插件在iOS平台上的功能目前有限。请考虑在iOS上使用其他方法进行文档处理。

添加插件

在 pubspec.yaml 文件中添加 doc_text：

dependencies:
  doc_text: ^0.0.1

使用示例

以下是一个完整的示例代码，展示了如何使用 doc_text 插件从Word文档中提取文本并显示在Flutter应用中：

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

import 'package:flutter/services.dart';
import 'package:doc_text/doc_text.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String? text;
  final _docTextPlugin = DocText();

  // 平台消息是异步的，因此我们在异步方法中初始化
  Future<void> extractTextFromDoc() async {
    FilePickerResult? result = await FilePicker.platform.pickFiles(
      type: FileType.custom,
      allowedExtensions: ['doc', 'docx'],
    );

    if (result != null) {
      PlatformFile file = result.files.first;

      try {
        text = await _docTextPlugin.extractTextFromDoc(file.path!) ??
            'Unknown platform version';
        if (!mounted) return;
        setState(() {});
      } on PlatformException {
        // 处理失败
      }
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Column(
          children: [
            SizedBox(
              height: MediaQuery.sizeOf(context).height * 0.6,
              child: SingleChildScrollView(
                child: Text(
                  text ?? 'Select file',
                ),
              ),
            ),
            Center(
              child: Row(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  ElevatedButton(
                    onPressed: extractTextFromDoc,
                    child: const Text('Open Doc file'),
                  ),
                  if (text != null)
                    ElevatedButton(
                      onPressed: () => setState(() {
                        text = null;
                      }),
                      child: const Text('Close file'),
                    ),
                ],
              ),
            )
          ],
        ),
      ),
    );
  }
}

贡献

我们欢迎对 doc_text 插件的贡献！如果您想贡献代码，请先 fork 仓库并提交 pull 请求。对于重大更改或新功能，请先创建一个 issue 进行讨论。

许可证

doc_text 采用 MIT 许可证。详情请参阅 LICENSE 文件。