0.1.0-dev.1 / 开发预览版已发布文件预览，
FILE PREVIEWS. THE FLUTTER WAY.
文件预览，
融入你的
Flutter 应用。
一套 Dart API，让文档、表格、演示与更多文件留在应用里。离线资源随包分发，应用级预热让下一次打开从容就绪。
Flutter 3.47+ · Dart 3.13+ · 无需转码服务器
FileViewerHost 应用级
your_flutter_app⌘
FIELD NOTES01 / 06
BUILD SOMETHING THAT FITS.
下一份文档，
留在你的应用里。
本地预览 · 统一交互 · 从容打开
FILE VIEWER × FLUTTER01
离线资源PDF · DOCX · XLSX · PPTX
FileViewer(source: document)</>↻退出路由，保留会话。
A SMALL API. A COMPLETE START.
从安装，到第一份文件。
配置宿主一次，然后用熟悉的 Flutter 方式构建。完整示例与平台差异，都已写进文档。
01
从 pub.dev 安装
匹配的资源包与平台适配器，一起就位。
pubspec.yaml
dependencies:
file_viewer_flutter: 0.1.0-dev.102
在应用根节点预热
首帧后准备查看器，后续页面复用会话。
Dart
runApp(
FileViewerHost(child: MyApp()),
);03
把预览放进页面
声明文件资源，并给查看器一个有界布局。
Dart
FileViewer(
source: FileViewerSource.asset(
'assets/report.pdf',
),
)原生端先执行一次 setup；示例中的文件需要在 assets 中声明。跟着完整快速开始操作
YOUR DOCUMENTS. YOUR SOURCES.
文件从哪里来，
由你的应用决定。
应用资源、设备文件、内存字节，或带鉴权的接口。同一个组件接住不同来源，路径与凭据留在 Dart 层。
了解文件来源Web 不读取任意原生路径；远程 URL 仍需要网络与相应的 CORS 配置。
source.dart
const source = FileViewerSource.asset(
'assets/report.pdf',
);
FileViewer(source: source)source.dart
const source = FileViewerSource.file(
'/path/to/report.docx',
name: 'report.docx',
);
FileViewer(source: source)source.dart
final source = FileViewerSource.bytes(
documentBytes,
name: 'report.xlsx',
);
FileViewer(source: source)source.dart
final source = FileViewerSource.url(
Uri.parse('https://your-api.example/document'),
name: 'contract.pdf',
headers: {'Authorization': 'Bearer <token>'},
);
FileViewer(source: source)⌑这是 API 示例；URL 与令牌均为占位符。
READY BEFORE THE NEXT ROUTE.
把准备工作，
放到打开之前。
Host 在首帧后预热，已知下一份文档时再提前解析。关闭页面后保留一个会话，让再次打开沿用文档与视图状态。
理解预热与生命周期FileViewerHost首帧后准备壳层与模块
warmUp()已知即将打开的文档按需提前解析，匹配来源与选项
preload()离开，再回来最多保留一个闲置会话，内存压力时释放
reuse预热就绪与文档首屏不同。后台保留受操作系统挂起与回收约束。
BUILD WITH A CLEAR SCOPE.
能力清晰，接入才从容。
这是正在持续验收的开发预览版。移动端使用系统 WebView，桌面端按平台交付，Worker、WASM、字体与资源随应用分发。
查看六端配置与已验证范围当前发布0.1.0-dev.1开发预览 · pub.dev
YOUR NEXT PREVIEW STARTS HERE.