在Flutter中，file_progress 是一个用于监控文件上传进度的插件。它可以帮助你在文件上传过程中实时获取上传进度，并在UI中显示进度条或其他反馈信息。下面是如何使用 file_progress 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 file_progress 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  file_progress: ^0.1.0  # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

2. 导入插件

在你的Dart文件中导入 file_progress 插件：

import 'package:file_progress/file_progress.dart';

3. 创建 FileProgress 实例

你需要创建一个 FileProgress 实例来监控文件上传的进度。

FileProgress fileProgress = FileProgress();

4. 开始上传文件并监控进度

假设你有一个文件上传的函数 uploadFile，你可以使用 fileProgress 来监控上传进度。

Future<void> uploadFile(File file) async {
  // 获取文件大小
  int fileSize = await file.length();

  // 开始上传
  Stream<int> uploadStream = yourUploadFunction(file);

  // 监控上传进度
  fileProgress.start(fileSize, uploadStream);

  // 监听进度变化
  fileProgress.progressStream.listen((progress) {
    print('Upload progress: $progress%');
  });

  // 等待上传完成
  await fileProgress.done;

  print('Upload completed!');
}

5. 在UI中显示进度

你可以使用 StreamBuilder 或 ValueListenableBuilder 来在UI中显示上传进度。

StreamBuilder<int>(
  stream: fileProgress.progressStream,
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      return CircularProgressIndicator(value: snapshot.data / 100);
    } else {
      return CircularProgressIndicator();
    }
  },
)

6. 处理上传完成

你可以使用 fileProgress.done 来等待上传完成，并在上传完成后执行一些操作。

await fileProgress.done;
print('File upload completed!');

7. 错误处理

你还可以监听错误流来处理上传过程中可能发生的错误。

fileProgress.errorStream.listen((error) {
  print('Upload error: $error');
});

8. 取消上传

如果你想取消上传，可以调用 cancel 方法。

fileProgress.cancel();

完整示例

import 'package:flutter/material.dart';
import 'package:file_progress/file_progress.dart';
import 'dart:io';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: FileUploadPage(),
    );
  }
}

class FileUploadPage extends StatefulWidget {
  [@override](/user/override)
  _FileUploadPageState createState() => _FileUploadPageState();
}

class _FileUploadPageState extends State<FileUploadPage> {
  FileProgress fileProgress = FileProgress();

  Future<void> uploadFile(File file) async {
    int fileSize = await file.length();
    Stream<int> uploadStream = yourUploadFunction(file);

    fileProgress.start(fileSize, uploadStream);

    fileProgress.progressStream.listen((progress) {
      print('Upload progress: $progress%');
    });

    await fileProgress.done;
    print('Upload completed!');
  }

  Stream<int> yourUploadFunction(File file) async* {
    // 模拟上传过程
    for (int i = 0; i <= 100; i++) {
      await Future.delayed(Duration(milliseconds: 100));
      yield i;
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('File Upload Progress'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            StreamBuilder<int>(
              stream: fileProgress.progressStream,
              builder: (context, snapshot) {
                if (snapshot.hasData) {
                  return CircularProgressIndicator(value: snapshot.data / 100);
                } else {
                  return CircularProgressIndicator();
                }
              },
            ),
            ElevatedButton(
              onPressed: () async {
                File file = File('path_to_your_file');
                await uploadFile(file);
              },
              child: Text('Upload File'),
            ),
          ],
        ),
      ),
    );
  }
}