Flutter文件管理插件firefile的使用

Flutter文件管理插件firefile的使用

开始使用

确保所有Firebase需求已安装。

使用方法

1. 初始化FirefileController：

controller = FirefileController();

1. 在小部件树中使用Firefile，提供上面初始化的controller和tileBuilder：

Firefile(
  controller: controller,
  tileBuilder: (task) {
    return ListTile(
      title: Text(task.fileName),
      trailing: _buildTrailing(task), // 完整示例在`example/`文件夹中
    );
  },
),

1. 它工作了！🎉

示例代码

以下是完整的示例代码，展示了如何使用Firefile插件。

import 'dart:math';

import 'package:file_picker/file_picker.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_storage/firebase_storage.dart';
import 'package:firefile/firefile.dart';
import 'package:flutter/material.dart';

void main() {
  const options = FirebaseOptions(
    apiKey: '<PROVIDE>',
    appId: '<THIS>',
    messagingSenderId: '<IF-YOU-WANT>',
    projectId: '<TO-TEST>',
  );

  Firebase.initializeApp(options: options);

  runApp(const ExampleApp());
}

class ExampleApp extends StatelessWidget {
  const ExampleApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Firefile Demo',
      theme: ThemeData(
        primarySwatch: Colors.red,
      ),
      home: const Example(),
    );
  }
}

class Example extends StatefulWidget {
  const Example({Key? key}) : super(key: key);

  [@override](/user/override)
  State<Example> createState() => _ExampleState();
}

class _ExampleState extends State<Example> {
  late FirefileController controller;

  [@override](/user/override)
  void initState() {
    controller = FirefileController(
      initialTasks: [
        FirefileTask.success(
          fileName: 'Custom file name',
          downloadUrl: '/some-download-url',
        ),
      ],
    );

    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Firefile example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(12),
        child: SizedBox(
          width: double.maxFinite,
          child: Column(
            children: [
              ElevatedButton.icon(
                onPressed: _onPickFile,
                icon: const Icon(Icons.folder),
                label: const Text('选择文件'),
              ),
              Expanded(
                child: Firefile(
                  controller: controller,
                  tileBuilder: (task) => ListTile(
                    title: Text(task.fileName),
                    trailing: _buildTrailing(task),
                  ),
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }

  Widget? _buildTrailing(FirefileTask task) {
    switch (task.state) {
      case TaskState.running:
        return IconButton(
          onPressed: () => controller.cancelTask(task, removeOnCancel: true),
          icon: Stack(
            fit: StackFit.passthrough,
            alignment: Alignment.center,
            children: [
              CircularProgressIndicator(
                value: task.progress,
                color: Colors.red,
              ),
              Text('${(task.progress * 100).round()}%'),
            ],
          ),
        );

      case TaskState.success:
        return const Text('成功 🎉');

      default:
        return null;
    }
  }

  void _onPickFile() async {
    final result = await FilePicker.platform.pickFiles(allowMultiple: true);

    if (result != null) {
      for (var file in result.files) {
        var name = file.name;
        final parts = name.split('.');
        name = '${parts.first}-'
            '${Random().nextInt(32).toString()}.'
            '${parts.last}';

        controller.uploadFile(
          data: file.bytes,
          childPath: name,
        );
      }
    } else {
      // 用户取消了选择
    }
  }
}