Firebase Storage上传PDF后在Flutter中持久下载与按需打开实现
现有代码的核心失效原因
- 存储路径选择错误:当前使用的
Directory.systemTemp是系统临时缓存目录,系统会在存储空间不足、应用被后台清理时随时删除该目录下的文件,无法满足应用重启后依然可访问的持久化要求 - 文件类型硬编码错误:不管下载的是PDF还是图片,都把本地文件命名为
tmp.jpg,直接把不同格式的二进制流都套上jpg后缀,不仅PDF完全无法识别,长期来看也会导致非jpg格式的图片出现解码失败的问题 - 展示逻辑不匹配:用
Image.memory组件解析下载的字节流,该组件仅能解码jpg、png等图片格式的二进制数据,完全无法识别PDF的文件结构,自然无法正常展示内容 - 逻辑冗余重复:下载流程里既通过http请求拉取了完整文件流,又调用Storage的写入方法重复下载,浪费流量的同时也容易出现文件写入冲突
- 缺少PDF查看核心能力:没有对接PDF渲染组件,也没有本地文件打开的逻辑,就算文件下载正确也无法触发查看动作
可直接匹配现有代码的修正方案
1. 替换为合法的持久存储路径
删除临时目录相关逻辑,改用应用专属文档目录存放PDF,该目录下的文件除非用户手动卸载应用,否则不会被系统自动清理。需要引入path_provider插件获取路径:
// 获取应用持久存储目录 final Directory appDocDir = await getApplicationDocumentsDirectory(); // 从Firebase Storage引用中提取原始文件名,保留正确后缀 final String fileName = await ref.getName(); final File localPdfFile = File('${appDocDir.path}/$fileName');
2. 重构下载流程
删除冗余的http请求逻辑,直接调用Firebase Storage提供的文件写入能力下载内容,增加本地文件存在判断,避免重复下载:
Future<void> downloadFile(StorageReference ref) async { // 先判断本地是否已存在该PDF if (await localPdfFile.exists()) { _openPdfViewer(localPdfFile); return; } // 不存在则下载到本地持久目录 final StorageFileDownloadTask downloadTask = ref.writeToFile(localPdfFile); final taskSnapshot = await downloadTask.future; print('下载完成:${taskSnapshot.totalByteCount} 字节'); // 下载完成后直接触发查看 _openPdfViewer(localPdfFile); }
如果是图片格式的文件,可以保留原有SnackBar展示逻辑,仅需把硬编码的tmp.jpg替换为根据实际文件后缀生成的合法文件名即可。
3. 实现PDF查看逻辑
引入flutter_pdfview插件实现应用内PDF渲染,不需要依赖外部第三方应用,加载本地文件路径即可完成内容展示:
void _openPdfViewer(File pdfFile) { Navigator.push( context, MaterialPageRoute( builder: (context) => PdfPreviewPage(pdfFile: pdfFile), ), ); } class PdfPreviewPage extends StatelessWidget { final File pdfFile; const PdfPreviewPage({super.key, required this.pdfFile}); @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar(title: const Text('PDF预览')), body: PdfView( controller: PdfController( document: PdfDocument.openFile(pdfFile.path), ), ), ); } }
4. 修正上传环节的元数据配置
原来的上传逻辑中contentType判断要针对PDF格式做兼容,避免元数据识别错误导致Storage端下载异常:
// upload方法内调整 String contentType; if (_extension == 'pdf') { contentType = 'application/pdf'; } else { contentType = '$_pickType/$_extension'; } final StorageUploadTask uploadTask = storageRef.putFile( File(filePath), StorageMetadata(contentType: contentType), );
内容的提问来源于stack exchange,提问作者srk2k14
相关产品推荐
相关产品推荐

