Flutter未知功能插件morpheme_cucumber的使用（注：由于介绍为undefined，以下基于插件名称进行合理推测） **输出**： Flutter文本处理插件morpheme_cucumber的使用

根据你提供的内容和示例代码，以下是关于“Flutter文本处理插件morpheme_cucumber的使用”的详细内容和完整示例Demo。

Flutter文本处理插件morpheme_cucumber的使用

morpheme_cucumber 包建立在 patrol 和 integration_test 之上，使得使用 Gherkin 语言进行集成测试变得简单。它可以在 morpheme_cli 上使用。

安装

首先，安装 morpheme_cli：

dart pub global activate morpheme_cli

然后，在你的项目中安装 morpheme flutter：

morpheme create

配置 morpheme_cli

现在你已经完成了所有 MorphemeCucumber 的设置，你可以调用 morpheme 命令：

1. 初始化以创建 morpheme.yaml 文件：

morpheme init

1. 下载所有依赖项：

morpheme get

1. 最后运行 Cucumber 命令：

morpheme cucumber

默认情况下，运行 integration_test/cucumber_test.dart 文件，使用开发环境 (dev)。如果你想运行其他环境（例如 stag 或 prod），可以添加参数 --flavor stag 或 --flavor prod。

使用 morpheme_cucumber

要在项目中使用 morpheme_cucumber，你需要在 integration_test 目录下创建一个 cucumber_test.dart 文件，并导入该文件：

import 'package:morpheme_cucumber/morpheme_cucumber.dart';

导入后，你可以编写 widget 测试：

import 'support/cucumber_config.dart';
import 'support/cucumber_hook.dart';
import 'support/step_definitions.dart';

void main() async {
  await MorphemeCucumber(
    config: CucumberConfig(),
    hook: CucumberHook(),
    reporter: [JsonReporter(), StdoutReporter()],
    stepDefinitions: stepDefinitions,
  ).execute();
}

配置 Config

你可以创建 Config 类或将其设为默认值为 null：

import 'package:core/core.dart';
import 'package:morpheme_cucumber/morpheme_cucumber.dart';

class CucumberConfig extends Config {
  @override
  bool get nativeAutomation => false;

  @override
  NativeAutomatorConfig get nativeAutomatorConfig =>
      const NativeAutomatorConfig(
        androidAppName: Environment.appName,
        iosAppName: Environment.appName,
        packageName: Environment.androidApplicationId,
        bundleId: Environment.iosApplicationId,
      );

  @override
  PatrolTesterConfig get patrolTesterConfig => const PatrolTesterConfig(
        visibleTimeout: Duration(minutes: 1),
      );

  @override
  bool get skipScenario => false;

  @override
  Duration get timeout => const Duration(minutes: 5);
}

配置 Hook

你可以添加自己的 Hook 用于 Cucumber：

import 'package:core/core.dart';
import 'package:morpheme_cucumber/morpheme_cucumber.dart';
import 'package:morpheme_flutter_starter_kit/main.dart' as app;

class CucumberHook extends Hook {
  @override
  Future<void> onBeforeExecute() async {
    await app.init();
  }

  @override
  Future<void> onAfterExecute() async {}

  @override
  Future<void> onBeforeFeature(PatrolTester $) async {}

  @override
  Future<void> onAfterFeature(PatrolTester $) async {
    await FlutterSecureStorageHelper.logout();
  }

  @override
  Future<void> onBeforeScenario(PatrolTester $) async {
    await $.pumpWidget(const app.MyApp());
  }

  @override
  Future<void> onAfterScenario(PatrolTester $) async {
    locator<GoRouter>().go('/');
  }

  @override
  Future<void> onBeforeStep(PatrolTester $) async {}

  @override
  Future<void> onAfterStep(PatrolTester $) async {}
}

步骤定义 Step Definitions

步骤定义存储在 step_definitions.dart 文件中：

import 'package:flutter/material.dart';
import 'package:morpheme_cucumber/morpheme_cucumber.dart';

Map<RegExp, Function> stepDefinitions = {
  // 行动
  RegExp(r'I wait for "([^"]*)" key to visible'):
      (PatrolTester $, String key) async {
    await $(Key(key)).waitUntilVisible();
  },
  RegExp(r'I clear textfield in "([^"]*)" key'):
      (PatrolTester $, String key) async {
    await $(Key(key)).enterText('');
  },
  RegExp(r'I enter "([^"]*)" into "([^"]*)" key'):
      (PatrolTester $, String value, String key) async {
    await $(Key(key)).enterText(value);
  },
  RegExp(r'I scroll in "([^"]*)" key until visible "([^"]*)" key'):
      (PatrolTester $, String scrollKey, String visibleKey) async {
    await $(Key(visibleKey))
        .scrollTo(scrollable: $(Key(scrollKey)).$(Scrollable));
  },
  RegExp(r'I tap "([^"]*)" key'): (PatrolTester $, String key) async {
    await $(Key(key)).tap();
  },
  RegExp(r'I longtap "([^"]*)" key'): (PatrolTester $, String key) async {
    await $.tester.longPress($(key));
  },
};

你可以添加自定义的步骤定义，使用 RegExp 进行匹配。

在 pubspec.yaml 中添加资源

1. 创建目录 integration_test/ndjson/
2. 然后在 pubspec.yaml 中添加资源：

flutter:
  uses-material-design: true
  assets:
    - integration_test/ndjson/

报告器 Reporters

报告器是可以报告测试运行状态的类。这可以简单地将场景结果记录到控制台。内置的报告器包括：

• StdoutReporter：将所有消息从测试运行记录到标准输出（控制台）。
• JsonReporter：创建一个包含测试运行结果的 JSON 文件，然后可以使用 cucumber-html-reporter 创建 HTML 报告。你可以传递要创建的 JSON 文件路径。

特性 Features

编写你的特性文件 integration_test/features/login.feature：

Feature: Login

  Scenario: Login with username and pin then failed
    When I enter "example@morpheme.id" into "inputEmail" key
    When I scroll in "scrollLogin" key until visible "inputPin" key
    When I enter "123455" into "inputPin" key
    When I scroll in "scrollLogin" key until visible "btnLogin" key
    When I tap "btnLogin" key

  Scenario: Login with username and pin then success
    When I enter "example@morpheme.id" into "inputEmail" key
    When I scroll in "scrollLogin" key until visible "inputPin" key
    When I enter "123456" into "inputPin" key
    When I scroll in "scrollLogin" key until visible "btnLogin" key
    When I tap "btnLogin" key