Flutter文档或内容查看插件dd_viewer的使用

dd_viewer

dd_viewer 是一个通用的预览设备，用于预览PDF、Word、Excel、文本、PNG和JPG文件。

该插件提供了一个办公预览套件，支持预览PDF、Excel、Word等类型的文件。它不依赖于腾讯TBS。

Android

在 android/build.gradle 中添加以下代码：

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

iOS

请在 Podfile 文件中设置最低版本为12：

platform :ios, '12.0'

config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'

举个例子:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'
    end
  end
end

打开Excel文件

DdViewerApi().openXlsFile(FileX.netWork(url: 'http://host:port/wd/excel.xls'));

使用

dd_viewer 支持打开网络文件和本地文件。网络文件将使用 dio 下载到本地缓存目录。

file: FileX.netWork(); // 网络文件
file: FileX.file(); // 本地文件
file: FileX.path(); // 文件路径

完整例子

import 'package:dd_viewer/dd_viewer.dart';
import 'package:dd_viewer/model/filex.dart';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  final pdfUrl = "http://host:port/wd/pdf.pdf";
  final excUrl = "http://host:port/wd/excel.xls";
  final docUrl = "http://host:port/wd/文档.docx";
  final jpg = 'http://host:port/wd/3.jpg';
  final png = 'http://host:port/wd/2.png';
  final jpeg = 'http://host:port/wd/1.jpeg';

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('超级视图'),
        ),
        body: GridView.count(
          crossAxisCount: 2,
          children: [
            SuperView(file: FileX.netWork(url: docUrl)),
            SuperView(file: FileX.netWork(url: excUrl)),
            SuperView(file: FileX.netWork(url: pdfUrl)),

            SuperView(file: FileX.netWork(url: jpg)),
            SuperView(file: FileX.netWork(url: png)),
            SuperView(file: FileX.netWork(url: jpeg)),
          ],
        ),
      ),
    );
  }
}

示例代码

import 'package:dd_viewer/dd_viewer.dart';
import 'package:dd_viewer/model/filex.dart';
import 'package:flutter/material.dart';
import 'package:path/path.dart' as path;

import 'doc.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  final pdfUrl = "http://ip:port/wd/pdf.pdf";
  final excUrl = "http://ip:port/wd/excel.xls";
  final docUrl = "http://ip:port/wd/文档.docx";
  final jpg = 'http://ip:port/wd/3.jpg';
  final png = 'http://ip:port/wd/2.png';
  final jpeg = 'http://ip:port/wd/1.jpeg';

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('超级视图'),
          actions: [
            Builder(
              builder: (c) {
                return FilledButton.tonal(
                  onPressed: () {
                    Navigator.push(c, MaterialPageRoute(builder: (_) => const DocView()));
                  },
                  child: const Text('doc页面测试'),
                );
              }
            )
          ],
        ),
        body: GridView.count(
          crossAxisCount: 2,
          children: [
            SuperView(file: FileX.netWork(url: docUrl)),
            FilledButton(
              onPressed: () {
                DdViewerApi().openXlsFile(FileX.netWork(url: 'http://ip:port/wd/excel.xls'));
              },
              child: const Text('打开xls'),
            ),
            SuperView(file: FileX.netWork(url: pdfUrl)),

            SuperView(file: FileX.netWork(url: jpg)),
            SuperView(file: FileX.netWork(url: png)),
            SuperView(file: FileX.netWork(url: jpeg)),
          ],
        ),
      ),
    );
  }

  void isXlsFile() {
    final fileType = getFileType('http://ip:port/wd/excel.xls');
    if (fileType == SupportFile.xls) {
      DdViewerApi().openXlsFile(FileX.netWork(url: 'http://ip:port/wd/excel.xls'));
    }
  }

  SupportFile getFileType(String url) {
    final ex = path.extension(url);
    switch (ex) {
      case '.xls':
        return SupportFile.xls;
      case '.pdf':
        return SupportFile.pdf;
      case '.docx':
        return SupportFile.word;
      case '.jpg':
        return SupportFile.img;
      case '.png':
        return SupportFile.img;
      case '.jpeg':
        return SupportFile.img;
      default:
        return SupportFile.noSupport;
    }
  }
}