## 简介
使用file_preview可以像在使用Flutter weidget一样在andorid、ios页面中预览doc、docx、rtf、ppt、pptx、xls、xlsx、xlsm、csv、pdf、txt、epub、chm等文件。
[演示app](https://www.pgyer.com/file_preview)
## 说明
* andorid使用腾讯[TBS](https://cloud.tencent.com/product/tbs)服务，支持doc、docx、rtf、ppt、pptx、xls、xlsx、xlsm、csv、pdf、txt、epub、chm文件的预览
* ⚠️[关于腾讯浏览服务内核SDK-内核文档能力调整公告](https://mp.weixin.qq.com/s/rmSa4Fs77MDdjFioRKwXPA),x5内核版本不再维护（v1分支），新版插件已切换为[新版浏览服务内核](https://cloud.tencent.com/product/tbs) 使用方法不变
* ios使用WKWebView，WKWebView所支持的均可预览
* andorid在线预览时会下载文件至本地再进行预览，文件格式根据url后缀或者[Content-Type](https://github.com/gstory0404/file_preview/blob/master/android/src/main/kotlin/com/gstory/file_preview/utils/ext.kt)来判断，同url文件再次预览不再下载直接读取本地缓存，如需重新下载则调用删除缓存方法。
ios不受影响。
## 版本更新
[更新日志](https://github.com/gstory0404/file_preview/blob/master/CHANGELOG.md)
## 支持格式
|格式|android|ios|
|:----|:----:|:----:|
|.doc| ✅ | ✅ |
|.docx| ✅ | ✅ |
|.ppt| ✅ | ✅ |
|.pptx| ✅ | ✅ |
|.xls| ✅ | ✅ |
|.xlsx| ✅ | ✅ |
|.pdf|✅ | ✅ |
|.OFD|✅ | ✅ |
|more| TBS限制不可预览 | WKWebView支持均可预览 |
## 集成步骤
### 1、pubspec.yaml
```Dart
//v2
file_preview: ^latest
//v1
file_preview:
git:
url: https://github.com/gstory0404/file_preview.git
ref: v1
```
### 2、引入
```Dart
import 'package:file_preview/file_preview.dart';
```
### 3、TBS初始化
由于使用android使用TBS服务，所以必须在FilePreviewWidget使用前完成初始化，不然无法加载。
```dart
await FilePreview.initTBS(license: "your license");
```
### 3、获取TBS版本
```dart
String version = await FilePreview.tbsVersion();
```
### 4、预览文件
```dart
//使用前进行判断是否已经初始化
var isInit = await FilePreview.tbsHasInit();
if (!isInit) {
await FilePreview.initTBS();
return;
}
```
```dart
//文件控制器
FilePreviewController controller = FilePreviewController();
//切换文件
//path 文件地址 https/http开头、文件格式结尾的地址，或者本地绝对路径
controller.showFile(path);
//文件预览widget
FilePreviewWidget(
controller: controller,
width: 400,
height: 600,
//path 文件地址 https/http开头、文件格式结尾的地址，或者本地绝对路径
path: widget.path,
callBack: FilePreviewCallBack(onShow: () {
print("文件打开成功");
}, onDownload: (progress) {
print("文件下载进度$progress");
}, onFail: (code, msg) {
print("文件打开失败 $code $msg");
}),
),
```
### 5、删除本地缓存
andorid预览在线文件需要先将文件下载到本地/data/user/0/包名/files/file_preview/目录下，
可以通过以下方法删除缓存，仅andorid生效
```dart
await FilePreview.deleteCache();
```
### 6、http配置
高版本andorid、ios默认禁用http，可以设置打开防止文件加载失败
* Android
android/app/src/main/res/xml下新建network_config.xml
```