Flutter使用Syncfusion PDFViewer组件无操作持续重绘问题求助
问题原因
你遇到的无操作持续重绘是旧版Syncfusion Flutter PDFViewer的已知特性,和PDF加载来源无关。组件内置了可视区域校验、预加载缓存同步、页码状态更新的定时逻辑,早期2.x适配版本未做无操作场景的重绘裁剪,所以会出现静态页面持续刷新的情况。
不需要额外通过setState强行停止刷新,错误的状态调用反而会加剧性能消耗,按如下方案优化即可。
修复方案
- 第一步:将
PdfViewerApp改为Stateful组件,缓存PDFViewer控制器和实例,避免页面重构建时重复初始化组件 - 第二步:用
RepaintBoundary包裹PDFViewer组件,将重绘范围限制在组件自身子树,不会影响全局其他组件的渲染 - 第三步:通过组件内置参数,关闭非必要的内置特性,减少内部重绘触发逻辑
- 可选:将
syncfusion_flutter_pdfviewer依赖版本锁定为20.4.54,该版本是适配Flutter 2.2.x的稳定版本,已对无操作重绘问题做了专门优化
优化后代码
import 'package:flutter/material.dart'; import 'package:syncfusion_flutter_pdfviewer/pdfviewer.dart'; void main() { runApp(const MyApp()); } class MyApp extends StatelessWidget { const MyApp({Key? key}) : super(key: key); @override Widget build(BuildContext context) { return MaterialApp( title: 'SF PDFViewer Test', theme: ThemeData( primarySwatch: Colors.blue, ), home: const MyHomePage(), ); } } class MyHomePage extends StatefulWidget { const MyHomePage({Key? key}) : super(key: key); @override _MyHomePageState createState() => _MyHomePageState(); } class _MyHomePageState extends State<MyHomePage> { @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: const Text('SF PDF Viewer Example'), ), body: const Center(), floatingActionButton: FloatingActionButton( onPressed: () => Navigator.push( context, MaterialPageRoute(builder: (context) => const PdfViewerApp())), tooltip: 'View PDF', child: const Icon(Icons.document_scanner_rounded), ), ); } } // 改为Stateful组件缓存实例 class PdfViewerApp extends StatefulWidget { const PdfViewerApp({Key? key}) : super(key: key); @override State<PdfViewerApp> createState() => _PdfViewerAppState(); } class _PdfViewerAppState extends State<PdfViewerApp> { late PdfViewerController _pdfViewerController; @override void initState() { super.initState(); _pdfViewerController = PdfViewerController(); } @override void dispose() { _pdfViewerController.dispose(); super.dispose(); } @override Widget build(BuildContext context) { return SafeArea( child: Scaffold( appBar: AppBar( title: const Text('SF PDFViewer'), ), // RepaintBoundary隔离重绘区域 body: RepaintBoundary( child: SfPdfViewer.network( 'http://www.pdf995.com/samples/pdf.pdf', controller: _pdfViewerController, // 关闭非必要特性减少重绘 canShowPaginationDialog: false, canShowScrollHead: false, ), ), ), ); } }
验证方式
修改后打开Flutter性能面板的重绘高亮功能,文档加载完成后无操作状态下,组件不会再持续触发全局重绘,仅在用户进行滚动、缩放等交互时才会执行必要的渲染更新。
内容的提问来源于stack exchange,提问作者Mike
相关产品推荐
相关产品推荐

