Flutter PDF阅读插件advance_pdf_viewer_fork的使用

简介

advance_pdf_viewer_fork 是一个用于处理PDF文件的Flutter插件，支持Android和iOS平台。它最初是基于https://github.com/lohanidamodar/pdf_viewer fork而来，而后者又是从https://github.com/CrossPT/flutter_plugin_pdf_viewer fork出来的。

安装

在您的 pubspec.yaml 文件中添加 advance_pdf_viewer_fork 作为依赖项：

dependencies:
  advance_pdf_viewer_fork: any

使用方法

加载PDF

可以通过三种方式加载PDF文档：从assets、从URL或从本地文件系统。

• 从assets加载

  PDFDocument doc = await PDFDocument.fromAsset('assets/test.pdf');
  

• 从URL加载

  PDFDocument doc = await PDFDocument.fromURL('http://www.africau.edu/images/default/sample.pdf');
  

• 从文件加载

  File file = File('...');
  PDFDocument doc = await PDFDocument.fromFile(file);
  

加载特定页面

可以加载指定页数的PDF页面：

PDFPage pageOne = await doc.get(page: _number);

使用预构建的查看器

使用预构建的PDF查看器组件来展示PDF文档：

@override
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(
      title: Text('Example'),
    ),
    body: Center(
      child: _isLoading
          ? Center(child: CircularProgressIndicator())
          : PDFViewer(document: document),
    ),
  );
}

这个代码片段会生成如下的视图：

示例代码

下面是一个完整的示例应用程序，展示了如何使用 advance_pdf_viewer_fork 插件加载和显示PDF文件，并提供了一些额外的功能，例如从不同来源加载PDF文件以及切换PDF显示模式等。

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:advance_pdf_viewer_fork/advance_pdf_viewer_fork.dart';

void main() => runApp(App());

class App extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MyApp(),
    );
  }
}

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

class _MyAppState extends State<MyApp> {
  bool _isLoading = true;
  PDFDocument document;
  bool _usePDFListView = false;

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

  @override
  void dispose() {
    document.clearImageCache();
    document = null;
    super.dispose();
  }

  loadDocument() async {
    document = await PDFDocument.fromAsset('assets/sample.pdf');
    setState(() => _isLoading = false);
  }

  changePDF(value) async {
    setState(() => _isLoading = true);
    if (value == 1) {
      document = await PDFDocument.fromAsset('assets/sample2.pdf');
    } else if (value == 2) {
      document = await PDFDocument.fromURL("http://conorlastowka.com/book/CitationNeededBook-Sample.pdf");
    } else {
      document = await PDFDocument.fromAsset('assets/sample.pdf');
    }
    setState(() => _isLoading = false);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      drawer: Drawer(
        child: Column(
          children: <Widget>[
            SizedBox(height: 36),
            ListTile(
              title: Text('Load from Assets'),
              onTap: () {
                changePDF(1);
              },
            ),
            ListTile(
              title: Text('Load from URL'),
              onTap: () {
                changePDF(2);
              },
            ),
            ListTile(
              title: Text('Restore default'),
              onTap: () {
                changePDF(3);
              },
            ),
          ],
        ),     
      ),
      appBar: AppBar(
        title: const Text('FlutterPluginPDFViewer'),
        actions: <Widget>[
          GestureDetector(
            onTap: (){
              _usePDFListView = !_usePDFListView;
              setState(() {});
            },
            child: Icon(Icons.cached),
          ),
          SizedBox(width: 15,)
        ],
      ),
      body: Column(
        children: <Widget>[
          !_usePDFListView
          ? Expanded(
              child: Center(
                child: _isLoading
                    ? Center(child: CircularProgressIndicator())
                    : PDFViewer(
                        document: document,
                        zoomSteps: 1,
                        //uncomment below line to preload all pages
                        // lazyLoad: false,
                        // uncomment below line to scroll vertically
                        // scrollDirection: Axis.vertical,

                        // enableSwipeNavigation: false,
                        showPicker: false,
                        showNavigation: true,
                        //uncomment below code to replace bottom navigation with your own
                        /* navigationBuilder:
                            (context, page, totalPages, jumpToPage, animateToPage) {
                          return ButtonBar(
                            alignment: MainAxisAlignment.spaceEvenly,
                            children: <Widget>[
                              IconButton(
                                icon: Icon(Icons.first_page),
                                onPressed: () {
                                  jumpToPage(page: 0);
                                },
                              ),
                              IconButton(
                                icon: Icon(Icons.arrow_back),
                                onPressed: () {
                                  animateToPage(page: page - 2);
                                },
                              ),
                              IconButton(
                                icon: Icon(Icons.arrow_forward),
                                onPressed: () {
                                  animateToPage(page: page);
                                },
                              ),
                              IconButton(
                                icon: Icon(Icons.last_page),
                                onPressed: () {
                                  jumpToPage(page: totalPages - 1);
                                },
                              ),
                            ],
                          );
                        }, */
                      ),
              ),
            )
          : Expanded(
              child: _isLoading 
                ? Center(child: CircularProgressIndicator(),)
                : PDFListViewer(
                    document: document,
                    preload: true,
                  ),
            ),
        ],
      ),
    );
  }
}

待办事项

• 支持密码保护的PDF文件

使用的第三方库

希望这篇文档能够帮助您更好地理解和使用 advance_pdf_viewer_fork 插件。如果有任何问题或需要进一步的帮助，请随时提问！