Flutter书籍管理或阅读插件bookfx_mz的使用

Flutter书籍管理或阅读插件bookfx_mz的使用

模拟纸质书籍翻页效果

本项目主要模拟了我们在看书籍时的翻页动作，并支持了电子书直接预览。如果你阅读文本电子书，可以直接使用EBook组件；如果你用来阅读其他例如插画等不需要计算字数的内容，请使用BookFx组件。

目前支持的功能

1. 支持直接读取txt文件文本阅读，调整字号，模拟翻页。
2. 支持自定义当前页、下一页、指定页面的Widget布局内容。
3. 支持手势横向滑动翻页，优化了手势控制区域，支持返回上一页。
4. 支持翻页动画自定义设置。
5. 支持跳到指定页。

使用

导入：

import 'package:bookfx_mz/bookfx.dart';

如果你想用在书籍需要计算文字的场景，可以使用EBook；如果你想用在其他场景，例如插画，可以使用BookFx，自定义布局。

效果

电子书：

插画：

示例代码

电子书：

EBook(
  maxWith: MediaQuery.of(context).size.width,
  eBookController: eBookController,
  bookController: bookController,
  data: data,
  fontSize: eBookController.fontSize,
  padding: const EdgeInsetsDirectional.all(15),
  maxHeight: 600,
)

插画：

BookFx(
  size: Size(MediaQuery.of(context).size.width, 600),
  pageCount: images.length,
  currentPage: (index) {
    return Image.asset(
      images[index],
      fit: BoxFit.fill,
      width: MediaQuery.of(context).size.width,
    );
  },
  lastCallBack: (index) {
    if (index == 0) {
      return;
    }
    setState(() {});
  },
  nextPage: (index) {
    return Image.asset(
      images[index],
      fit: BoxFit.fill,
      width: MediaQuery.of(context).size.width,
    );
  },
  controller: bookController,
)

完整示例Demo

import 'dart:ui';

import 'package:flutter/material.dart';
import 'package:bookfx_mz/bookfx.dart';
import 'package:stack_trace/stack_trace.dart';

void main() {
  // 设置 Flutter 错误处理
  FlutterError.onError = (FlutterErrorDetails details) {
    FlutterError.presentError(details);
    
    // 格式化错误信息和堆栈跟踪
    final stack = details.stack;
    if (stack != null) {
      // 使用 Trace 来解析堆栈
      final trace = Trace.from(stack);
      final frames = trace.frames;
      
      debugPrint('=== Error ===');
      debugPrint('${details.exception}');
      debugPrint('=== Stack trace ===');
      for (var frame in frames) {
        // 只打印应用代码相关的堆栈（排除框架代码）
        if (frame.library.contains('package:') || frame.library.startsWith('dart:')) {
          debugPrint('${frame.uri}:${frame.line}:${frame.column} - ${frame.member}');
        }
      }
    }
  };

  // 捕获异步错误
  PlatformDispatcher.instance.onError = (error, stack) {
    debugPrint('=== Async Error ===');
    debugPrint('$error');
    
    // 格式化堆栈跟踪
    final trace = Trace.from(stack);
    final frames = trace.frames;
    
    debugPrint('=== Stack trace ===');
    for (var frame in frames) {
      if (frame.library.contains('package:') || frame.library.startsWith('dart:')) {
        debugPrint('${frame.uri}:${frame.line}:${frame.column} - ${frame.member}');
      }
    }
    
    return true;
  };
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'BookFX Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final BookController _bookController = BookController();
  final EBookController _eBookController = EBookController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('BookFX Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            SizedBox(
              width: 500,
              height: 200,
              child: BookFx(
                size: const Size(500, 200),
                pageCount: 5,
                currentBgColor: Colors.grey.shade200,
                duration: const Duration(milliseconds: 800),
                currentPage: (index) => Container(
                  color: Colors.white,
                  child: Center(
                    child: Text(
                      'Page ${index + 1}',
                      style: const TextStyle(fontSize: 24),
                    ),
                  ),
                ),
                nextPage: (index) => Container(
                  color: Colors.white,
                  child: Center(
                    child: Text(
                      'Page ${index + 1}',
                      style: const TextStyle(fontSize: 24),
                    ),
                  ),
                ),
                controller: _bookController,
              ),
            ),
            const SizedBox(height: 20),
            Row(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                ElevatedButton(
                  onPressed: () => _bookController.last(),
                  child: const Text('Previous'),
                ),
                const SizedBox(width: 20),
                ElevatedButton(
                  onPressed: () => _bookController.next(),
                  child: const Text('Next'),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    _bookController.dispose();
    _eBookController.dispose();
    super.dispose();
  }
}