Flutter时间限制插件minimum_duration的使用

Minimum Duration

这是一个简单的工具函数，用于强制一个操作至少花费给定的时间。

这在确保某些“加载”动画至少显示足够长的时间以便用户能看到它时非常有用，即使加载操作完成得非常快。

这是一个非常简单的实现，但它帮助我避免在每个应用程序中重复编写相同的代码，希望也能帮助到你！

开始使用

只需安装该包。

dart/flutter pub add minimum_duration

使用方法

基本用法

使用MinimumDuration很简单！只需将一个函数传递给MinimumDuration.run。

setLoading(true);

final result = await MinimumDuration.run(
  () async => someAsyncOperation(),
);

setLoading(false);

在这个例子中，someAsyncOperation的返回值将在至少500毫秒（默认持续时间）后被分配给result。

如果您的函数执行时间超过指定的持续时间，它将在完成后立即返回。

自定义持续时间

默认持续时间为500毫秒，但可以通过向duration参数提供一个值轻松覆盖它。

final result = await MinimumDuration.run(
  () async => someAsyncOperation(),
  duration: const Duration(seconds: 1),
);

全局默认持续时间

也可以通过更改MinimumDuration.duration属性来全局设置默认值。

// 在应用程序初始化代码中的某处
MinimumDuration.duration = const Duration(seconds: 1);

// 稍后，在应用程序逻辑中
// 这将以1秒的“默认”持续时间运行
final result = await MinimumDuration.run(
  () async => someAsyncOperation(),
);

这在默认值不符合您的用例并且不想为每次调用MinimumDuration.run传递自定义持续时间的情况下非常有用。

示例代码

import 'package:minimum_duration/minimum_duration.dart';

void main() async {
  await defaultDurationExample();
  await explicitDurationExample();

  MinimumDuration.duration = const Duration(milliseconds: 1500);
  await globallyConfiguredDefaultExample();
  MinimumDuration.reset();
}

Future<void> defaultDurationExample() async {
  final startTime = DateTime.now();

  // 将您的逻辑包装在`MinimumDuration.run`调用中
  final _ = await MinimumDuration.run(() {
    // 这里的逻辑将会执行，但结果不会在最小持续时间到达之前返回（默认为500毫秒）。
    return 'hello world';
  });

  final endTime = DateTime.now();
  final elapsed = endTime.difference(startTime);

  print('[DEFAULT (500ms)] completed in $elapsed');
}

Future<void> explicitDurationExample() async {
  final startTime = DateTime.now();

  // 将您的逻辑包装在`MinimumDuration.run`调用中，
  // 并传递一个`duration`参数。
  final _ = await MinimumDuration.run(
    () => 'hello world',
    duration: const Duration(seconds: 2),
  );

  final endTime = DateTime.now();
  final elapsed = endTime.difference(startTime);

  print('[EXPLICIT (2s)] completed in $elapsed');
}

Future<void> globallyConfiguredDefaultExample() async {
  final startTime = DateTime.now();
  // 设置全局默认持续时间（参见上面`main`函数中的第7行）。
  // 然后像往常一样将您的逻辑包装在`MinimumDuration.run`中。
  final _ = await MinimumDuration.run(() => 'hello world');

  final endTime = DateTime.now();
  final elapsed = endTime.difference(startTime);

  print('[CONFIGURED (1500ms)] completed in $elapsed');
}