Flutter模拟数据插件mockitory的使用

该插件的目的在于帮助测试Flutter应用时使用假数据，而无需修改代码。

通过使用Mockitory，你可以通过添加flutter_mockitory小部件来模拟数据层。

如何使用？

添加依赖

在pubspec.yaml文件中添加依赖：

dependencies:
  flutter_mockitory: 

如果你想要使用纯Dart的Mockitory（例如用于服务器端的应用），可以使用mockitory代替flutter_mockitory依赖。

使用Mockitory混入

首先导入Mockitory库：

import 'package:mockitory/mockitory.dart';

然后创建一个类并使用Mockitory混入：

enum Gender { male, female }

class ExampleMockitory with Mockitory {
  // 提供初始的模拟值
  [@override](/user/override)
  Map<String, MockValue> get initialMockValues => {
        'boolValue': MockValue<bool>(true),
        'intValue': MockValue<int>(1),
        'doubleValue': MockValue<double>(4.5),
        'gender': MockValue<Gender>(Gender.male),
        'listOfInts': MockValue<List<int>>([0, 1]),
        'dateValue': MockValue<DateTime>(DateTime(2020, 5, 5)),
      };

  // 观察性别变化
  Stream<Gender> observeGender() => observeMockValueUpdates<Gender>('gender')
      .map((mockValue) => mockValue.value);

  // 获取日期值
  DateTime getDateValue() => getValue<DateTime>('dateValue');
}

注意： 记住要使用类型化的MockValue对象。例如：MockValue<bool>(true)。

使用MockitoryPage小部件

MockitoryPage小部件用于自动生成用于更新/显示假数据的小部件列表。

final mockitory = ExampleMockitory();

// 使用MockitoryPage
MockitoryPage(
  mockitory: mockitory,
  customDelegates: [
    CustomBoolMockValueDelegate(), // 自定义布尔值委托
    ChoicesMockValueDelegate<Gender>([Gender.male, Gender.female]), // 性别选择器
    IterableMockValueDelegate<int>([0, 1], [1, 4, 5]), // 整数列表选择器
  ],
)

内置的MockValue委托

这些委托用于定义如何构建用于操作假数据的小部件。

默认使用的委托包括：

• BoolMockValueDelegate
• StringMockValueDelegate
• IntMockValueDelegate
• DoubleMockValueDelegate
• DateTimeMockValueDelegate

需要添加到MockitoryPage小部件的customDelegates属性中的委托包括：

• ChoicesMockValueDelegate<T> - 例如：ChoicesMockValueDelegate<Gender>([Gender.male, Gender.female])
• IterableMockValueDelegate<T> - 例如：IterableMockValueDelegate<int>([0, 1], [1, 4, 5])

自定义委托

你也可以提供自己的自定义委托：

class CustomBoolMockValueDelegate extends MockValueDelegate<bool> {
  [@override](/user/override)
  Widget buildMockValueWidget(BuildContext context, bool value, onChanged) {
    return Checkbox(
      activeColor: Colors.red,
      value: value,
      onChanged: (value) => onChanged(MockValue(value)),
    );
  }
}

示例代码

以下是完整的示例代码：

import 'package:mockitory/mockitory.dart';

enum Gender { male, female }

class ExampleMockitory with Mockitory {
  [@override](/user/override)
  Map<String, MockValue> get initialMockValues => {
        'boolValue': MockValue<bool>(true),
        'intValue': MockValue<int>(1),
        'doubleValue': MockValue<double>(4.5),
        'gender': MockValue<Gender>(Gender.male),
        'listOfInts': MockValue<List<int>>([0, 1]),
        'dateValue': MockValue<DateTime>(DateTime(2020, 5, 5)),
      };

  Stream<Gender> observeGender() => observeMockValueUpdates<Gender>('gender')
      .map((mockValue) => mockValue.value);
}