搜索插件、代码仓与 APP 分类

插件详情v0.10.2

patrol_log

Log 包用于 Patrol,一个强大的 Flutter 原生 UI 测试框架。

AndroidiOSLinuxmacOSWebWindows
近 30 天下载
85.4万
喜欢数
7
Pub 分数
160

安装插件

flutter pub add patrol_log

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

patrol_log 是一个专为 Patrol(一个 Flutter 原生 UI 测试框架)设计的日志包。它在自动化 UI 测试过程中提供详细且结构化的日志记录,帮助开发者调试测试失败并实时监控应用行为。该包专为 Patrol 打造,可无缝集成到跨多个平台(包括 Android、iOS、Linux、macOS、Web 和 Windows)的测试工作流中。该包支持包含时间戳、测试上下文和可操作洞察的丰富日志输出,从而提升测试的可靠性和可维护性。非常适合在 Flutter 应用中实践稳健的端到端测试的团队。

适合场景

  • 调试 UI 测试失败
  • 监控测试执行流程
  • 在测试期间捕获运行时应用状态
  • 通过日志增强测试报告
  • 与 CI/CD 流水线集成

主要特点

  • 用于 UI 测试的结构化日志
  • 实时日志流
  • 跨平台支持
  • 测试上下文感知消息
  • 与 Patrol 框架的无缝集成

适合对象

  • 使用 Patrol 进行 UI 测试的 Flutter 团队
  • 需要详细测试诊断的开发人员
  • 需要可追溯测试日志的 CI/CD 环境
  • 专注于可靠端到端测试的团队

使用建议

  • 需要安装巡逻框架
  • 仅限于基于巡逻的测试套件之外使用
  • 可能会增加测试执行的详细程度
  • 最适合在开发和预发布环境中使用

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Patrol

patrol on pub.dev patrol_cli on pub.dev patrol_finders on pub.dev patrol_mcp on pub.dev patrol_discord code style patrol_github_stars patrol_x

A powerful, multiplatform E2E UI testing framework for Flutter apps that overcomes the limitations of integration_test by handling native interactions. Developed by LeanCode since 2022, battle-tested and shaped by production-grade experience.

Patrol promotional graphics

Learn more about Patrol:

How can we help you:

Patrol is an open-source framework created and maintained by LeanCode. However, if your company wants to scale fast and accelerate Patrol’s adoption, we offer a set of value-added services on top of the core framework.

You can find out more below:

[!NOTE] Patrol 4.7.0 adds Swift Package Manager support for iOS and macOS! If you migrate your project to SPM, a few small setup changes are needed — see the iOS setup guide for details.

Patrol custom finders

Flutter's finders are powerful, but not very intuitive to use.

We took them and made something awesome.

Thanks to Patrol's custom finders, you'll take your tests from this:

testWidgets('signs up', (WidgetTester tester) async {
  await tester.pumpWidget(AwesomeApp());
  await tester.pumpAndSettle();

  await tester.enterText(
    find.byKey(Key('emailTextField')),
    'charlie@root.me',
  );
  await tester.pumpAndSettle();

  await tester.enterText(
    find.byKey(Key('nameTextField')),
    'Charlie',
  );
  await tester.pumpAndSettle();

  await tester.enterText(
    find.byKey(Key('passwordTextField')),
    'ny4ncat',
  );
  await tester.pumpAndSettle();

  await tester.tap(find.byKey(Key('termsCheckbox')));
  await tester.pumpAndSettle();

  await tester.tap(find.byKey(Key('signUpButton')));
  await tester.pumpAndSettle();

  expect(find.text('Welcome, Charlie!'), findsOneWidget);
});

to this:

patrolTest('signs up', (PatrolIntegrationTester $) async {
  await $.pumpWidgetAndSettle(AwesomeApp());

  await $(#emailTextField).enterText('charlie@root.me');
  await $(#nameTextField).enterText('Charlie');
  await $(#passwordTextField).enterText('ny4ncat');
  await $(#termsCheckbox).tap();
  await $(#signUpButton).tap();

  await $('Welcome, Charlie!').waitUntilVisible();
});

Learn more about custom finders in the docs!

Patrol's custom finders are also available standalone in the patrol_finders package.

Patrol native automation

Flutter's default integration_test package can't interact with the OS your Flutter app is running on. This makes it impossible to test many critical business features, such as:

  • granting runtime permissions
  • signing into the app which through WebView or Google Services
  • tapping on notifications
  • much more!

Patrol's native automation feature solves these problems:

void main() {
  patrolTest('showtime', (PatrolIntegrationTester $) async {
    await $.pumpWidgetAndSettle(AwesomeApp());
    // prepare network conditions
    await $.platform.mobile.enableCellular();
    await $.platform.mobile.disableWifi();

    // toggle system theme
    await $.platform.mobile.enableDarkMode();

    // handle native location permission request dialog
    await $.platform.mobile.selectFineLocation();
    await $.platform.mobile.grantPermissionWhenInUse();

    // tap on the first notification
    await $.platform.mobile.openNotifications();
    await $.platform.mobile.tapOnNotificationByIndex(0);
  });
}

CLI

See packages/patrol_cli.

The CLI is needed to enable Patrol's native automation feature in integration tests. It also makes development of integration tests much faster thanks to [Hot Restart].

To run widget tests, you can continue to use flutter test.

Package

See packages/patrol.

CI/CD Workflows

See .github/WORKFLOWS.md for detailed documentation about all GitHub Actions workflows, including test schedules, Flutter versions, and deployment pipelines.

Patrol contracts generator

  1. (Optionally) add new request type:
class OpenAppRequest {
  late String appId;
}
  1. Add new method to NativeAutomator:
abstract class NativeAutomator<IOSServer, AndroidServer, DartClient> {
  ...
  void openApp(OpenAppRequest request);
  ...
}
  1. Run gen_from_schema script, few files will be updated

Develop patrol_cli

If you have previously activated patrol_cli run:

dart pub global deactivate patrol_cli

then

cd packages/patrol_cli
flutter pub global activate -s path .

🛠️ Maintained by LeanCode

This package is built with 💙 by LeanCode. We are top-tier experts focused on Flutter Enterprise solutions.

Why LeanCode?
  • Creators of Patrol – the next-gen testing framework for Flutter.

  • Production-Ready – We use this package in apps with millions of users.

  • Full-Cycle Product Development – We take your product from scratch to long-term maintenance.


Need help with your Flutter project?

👉 Hire our team   •   Check our other packages

所属分类

依赖

依赖清单 3 项

源码仓库

使用此插件的项目

暂无相关数据。

所在榜单