Flutter适配器插件adapters_flutter的使用

Flutter适配器插件adapters_flutter的使用

开始使用

要求

sdk: '>=3.0.0 <4.0.0'
flutter: '>=3.10.0'

安装

通过Dart安装：

dart pub add adapters_flutter

通过Flutter安装：

flutter pub add adapters_flutter

兼容性

使用方法

配置

以下是一些配置选项及其描述：

文件

在项目的根目录中创建名为testit.properties的文件：

adapterMode={%ADAPTER_MODE%}
automaticCreationTestCases={%AUTOMATIC_CREATION_TESTCASES%}
automaticUpdationLinksToTestCases={%AUTOMATIC_UPDATION_LINKS_TO_TESTCASES%}
certValidation={%CERTIFICATE_VALIDATION%}
configurationId={%CONFIGURATION_ID%}
isDebug={%IS_DEBUG%}
privateToken={%USER_PRIVATE_TOKEN%}
projectId={%PROJECT_ID%}
testIt={%TEST_IT%}
testRunId={%TEST_RUN_ID%}
testRunName={%TEST_RUN_NAME%}
url={%URL%}

命令行

flutter test --dart-define=tmsAdapterMode={%ADAPTER_MODE%} --dart-define=tmsAutomaticCreationTestCases={%AUTOMATIC_CREATION_TESTCASES%} --dart-define=tmsAutomaticUpdationLinksToTestCases={%AUTOMATIC_UPDATION_LINKS_TO_TESTCASES%} --dart-define=tmsCertValidation={%CERTIFICATE_VALIDATION%} --dart-define=tmsConfigFile={%CONFIG_FILE%}  --dart-define=tmsConfigurationId={%CONFIGURATION_ID%} --dart-define=tmsIsDebug={%IS_DEBUG%} --dart-define=tmsPrivateToken={%USER_PRIVATE_TOKEN%} --dart-define=tmsProjectId={%PROJECT_ID%} --dart-define=tmsTestIt={%TEST_IT%} --dart-define=tmsTestRunId={%TEST_RUN_ID%} --dart-define=tmsTestRunName={%TEST_RUN_NAME%} --dart-define=tmsUrl={%URL%}

自动测试元数据

使用元数据指定有关自动测试的信息。

测试参数描述

• description - 在自动测试卡片中指定的自动测试描述。
• externalId - 唯一的内部自动测试ID（用于Test IT）。
• links - 列在自动测试卡片中的链接。
• tags - 列在自动测试卡片中的标签。
• title - 在自动测试卡片中指定的自动测试名称。如果未指定，则使用测试名称。
• workItemsIds - 一种将自动测试与手动测试关联的方法。接收一组手动测试的ID。

函数描述

• addAttachment - 将单个附件添加到自动测试结果中。
• addAttachments - 将多个附件添加到自动测试结果中。
• addLink - 将单个链接添加到自动测试结果中。
• addLinks - 将多个链接添加到自动测试结果中。
• addMessage - 将消息添加到自动测试结果中。

步骤描述

• step - 实现自动测试步骤。

示例代码

以下是一个完整的示例代码：

#!/usr/bin/env dart

[@Tags](/user/Tags)(['suite_tag'])
import 'package:adapters_flutter/adapters_flutter.dart';
import 'package:universal_io/io.dart';

void main() {
  group('example group', () {
    setUpAll(() async {
      HttpOverrides.global = null;

      await step('setup all step', () {
        expect(0, 0);
      });
    });

    setUp(() async {
      await step('setup step', () {
        expect(0, 0);
      });
    });

    tmsTest('example test',
        externalId: 'example_externalId',
        links: {Link('https://www.example.org/')},
        tags: {'example_tag'},
        title: 'example_title',
        workItemsIds: {'47100'}, () async {
      await step('success step', () {
        expect(0, 0);
      });

      await step('success step with attachment', () async {
        await addAttachment('avatar.png');
      });

      await step('success step with link', () async {
        await addLink('https://www.example.org/');
      });

      await step('success step with message', () async {
        await addMessage('example message');
      });

      final actual = await step('success step with return value', () {
        return 0;
      });

      expect(actual, 0);

      await step('success root step', () async {
        await step('success child step', () {
          expect(0, 0);
        });
      });

      await step('failed step', () {
        throw Exception('example exception.');
      });
    });

    tmsTestWidgets('example widgets test',
        externalId: 'example_widgets_externalId',
        links: {Link('https://www.example.org/')},
        tags: {'example_tag_widgets'},
        title: 'example_title_widgets',
        workItemsIds: {'47100'}, (tester) async {
      await step('success step', () {
        expect(0, 0);
      });

      await step('success step with attachment', () async {
        await addAttachment('avatar.png');
      });

      await step('success step with link', () async {
        await addLink('https://www.example.org/');
      });

      await step('success step with message', () async {
        await addMessage('example message');
      });

      final actual = await step('success step with return value', () {
        return 0;
      });

      expect(actual, 0);

      await step('success root step', () async {
        await step('success child step', () {
          expect(0, 0);
        });
      });

      await step('failed step', () {
        throw Exception('example exception.');
      });
    });

    tearDown(() async {
      await step('teardown step', () {
        expect(0, 0);
      });
    });

    tearDownAll(() async {
      await step('teardown all step', () {
        expect(0, 0);
      });
    });
  });
}