К основному содержанию
скилл CX Codex

flutter-testing-skill — скилл для Claude Code: тесты Flutter и Dart

Скилл flutter-testing-skill генерирует виджет-тесты, интеграционные тесты и golden-тесты для Flutter на Dart. Запускает локально или на реальных устройствах через TestMu AI облако.

MIT 242 установок ★ 393 обновлён 2026-10-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add LambdaTest/agent-skills --skill flutter-testing-skill -a claude-code
Открыть на GitHub

Что делает flutter-testing-skill

Скилл автоматизирует написание тестов для Flutter-приложений. Определяет тип теста — unit, widget, интеграционный или golden (визуальная регрессия) — и генерирует код с правильной структурой и паттернами. Включает примеры с WidgetTester, поиском элементов по ключу и типу, действиями (тап, ввод текста, скролл), мокированием зависимостей через Mockito.

Для локального запуска нужны Flutter SDK и Dart. Для интеграционных тестов на реальных устройствах скилл использует TestMu AI облако (LambdaTest) — туда загружается собранное APK или iOS-приложение и запускается через Appium. Визуальные тесты сравнивают скриншоты с эталонными файлами в goldens/.

Анти-паттерны — отсутствие pumpAndSettle() после действий, поиск по динамическому тексту вместо ключей, тестирование деталей реализации вместо поведения. Скилл подсказывает, когда нужно мокировать сервисы и репозитории, чтобы тесты не лезли в реальные API.

Какие задачи решает

  • Написать виджет-тест для экрана логина с проверкой полей и кнопок
  • Проверить обработку ошибок при неверных учётных данных
  • Создать интеграционный тест полного потока приложения
  • Настроить visual regression-тесты для UI-компонентов
  • Замокировать AuthService и проверить вызовы в тесте

Примеры запросов агенту

  • Напиши widget-тест для экрана LoginScreen с проверкой наличия TextField и ElevatedButton
  • Сгенерируй интеграционный тест полного потока входа, включая навигацию на Dashboard
  • Создай golden-тест для проверки визуального совпадения экрана списка товаров

Как установить flutter-testing-skill

1Через Skills CLI (Vercel)

npx skills add LambdaTest/agent-skills --skill flutter-testing-skill -a claude-code

2Вручную: положить файлы

~/.claude/skills/flutter-testing-skill/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/flutter-testing-skill/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о flutter-testing-skill

Как установить flutter-testing-skill в Claude Code?

Выполни npx skills add LambdaTest/agent-skills --skill flutter-testing-skill -a claude-code, затем открой файл конфигурации по пути ~/.claude/skills/flutter-testing-skill/SKILL.md.

Что делает flutter-testing-skill?

Генерирует тесты для Flutter: widget-тесты для UI, интеграционные тесты для полных потоков, golden-тесты для визуальной регрессии. Включает паттерны поиска элементов, действий, мокирования и запуска на реальных устройствах через облако.

Какие требования для работы скилла?

Нужны Flutter SDK и Dart. Для локального запуска тестов достаточно этого. Для интеграционных тестов на реальных устройствах требуется аккаунт TestMu AI на LambdaTest и собранное приложение (APK или iOS).

Исходный текст

SKILL.md · MIT
---
name: flutter-testing-skill
description: >
  Generates Flutter widget tests, integration tests, and golden tests in Dart.
  Supports local execution and TestMu AI cloud for real device testing.
  Use when user mentions "Flutter", "widget test", "WidgetTester", "testWidgets",
  "flutter_test", "integration_test". Triggers on: "Flutter", "widget test",
  "Dart test", "testWidgets", "WidgetTester", "golden test".
languages:
  - Dart
category: mobile-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# Flutter Testing Skill

You are a senior Flutter developer specializing in testing.

## Step 1 — Test Type

```
├─ "unit test", "business logic", "model test"
│  └─ Unit test: test/ directory, flutter_test package
│
├─ "widget test", "component test", "UI test"
│  └─ Widget test: test/ directory, testWidgets()
│
├─ "integration test", "E2E", "full app test"
│  └─ Integration test: integration_test/ directory
│
├─ "golden test", "snapshot", "visual regression"
│  └─ Golden test: matchesGoldenFile()
│
└─ Ambiguous? → Widget test (most common)
```

## Core Patterns — Dart

### Widget Test (Most Common)

```dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:my_app/screens/login_screen.dart';

void main() {
  testWidgets('Login screen shows email and password fields', (WidgetTester tester) async {
    await tester.pumpWidget(const MaterialApp(home: LoginScreen()));

    // Verify fields exist
    expect(find.byType(TextField), findsNWidgets(2));
    expect(find.text('Email'), findsOneWidget);
    expect(find.text('Password'), findsOneWidget);
    expect(find.byType(ElevatedButton), findsOneWidget);
  });

  testWidgets('Login with valid credentials navigates to dashboard', (WidgetTester tester) async {
    await tester.pumpWidget(const MaterialApp(home: LoginScreen()));

    // Enter credentials
    await tester.enterText(find.byKey(const Key('emailField')), '[email protected]');
    await tester.enterText(find.byKey(const Key('passwordField')), 'password123');

    // Tap login button
    await tester.tap(find.byKey(const Key('loginButton')));
    await tester.pumpAndSettle(); // Wait for animations and navigation

    // Verify navigation
    expect(find.text('Dashboard'), findsOneWidget);
  });

  testWidgets('Shows error for invalid credentials', (WidgetTester tester) async {
    await tester.pumpWidget(const MaterialApp(home: LoginScreen()));

    await tester.enterText(find.byKey(const Key('emailField')), '[email protected]');
    await tester.enterText(find.byKey(const Key('passwordField')), 'wrong');
    await tester.tap(find.byKey(const Key('loginButton')));
    await tester.pumpAndSettle();

    expect(find.text('Invalid credentials'), findsOneWidget);
  });
}
```

### Finder Strategies

```dart
// By Key (best — explicit test identifiers)
find.byKey(const Key('loginButton'))
find.byKey(const ValueKey('email_input'))

// By Type
find.byType(ElevatedButton)
find.byType(TextField)
find.byType(LoginScreen)

// By Text
find.text('Login')
find.textContaining('Welcome')

// By Icon
find.byIcon(Icons.login)

// By Widget predicate
find.byWidgetPredicate((widget) => widget is Text && widget.data!.startsWith('Error'))

// Descendant/Ancestor
find.descendant(of: find.byType(AppBar), matching: find.text('Title'))
find.ancestor(of: find.text('Login'), matching: find.byType(Card))
```

### Actions

```dart
await tester.tap(finder);                    // Tap
await tester.longPress(finder);              // Long press
await tester.enterText(finder, 'text');      // Type text
await tester.drag(finder, const Offset(0, -300));  // Drag/scroll
await tester.fling(finder, const Offset(0, -500), 1000); // Fling/swipe

// CRITICAL: Always pump after actions
await tester.pump();                         // Single frame
await tester.pump(const Duration(seconds: 1)); // Advance time
await tester.pumpAndSettle();                // Wait for animations to finish
```

### Integration Test

```dart
// integration_test/app_test.dart
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:my_app/main.dart' as app;

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  testWidgets('Full login flow', (WidgetTester tester) async {
    app.main();
    await tester.pumpAndSettle();

    // Login
    await tester.enterText(find.byKey(const Key('emailField')), '[email protected]');
    await tester.enterText(find.byKey(const Key('passwordField')), 'password123');
    await tester.tap(find.byKey(const Key('loginButton')));
    await tester.pumpAndSettle();

    // Verify dashboard
    expect(find.text('Dashboard'), findsOneWidget);

    // Navigate to settings
    await tester.tap(find.byIcon(Icons.settings));
    await tester.pumpAndSettle();
    expect(find.text('Settings'), findsOneWidget);
  });
}
```

### Golden Tests (Visual Regression)

```dart
testWidgets('Login screen matches golden', (WidgetTester tester) async {
  await tester.pumpWidget(const MaterialApp(home: LoginScreen()));
  await tester.pumpAndSettle();

  await expectLater(
    find.byType(LoginScreen),
    matchesGoldenFile('goldens/login_screen.png'),
  );
});
```

```bash
# Generate golden files
flutter test --update-goldens

# Run golden comparison
flutter test
```

### Mocking Dependencies

```dart
// Using Mockito
import 'package:mockito/mockito.dart';
import 'package:mockito/annotations.dart';

@GenerateMocks([AuthService])
void main() {
  late MockAuthService mockAuth;

  setUp(() {
    mockAuth = MockAuthService();
  });

  testWidgets('Login calls auth service', (tester) async {
    when(mockAuth.login(any, any)).thenAnswer((_) async => true);

    await tester.pumpWidget(MaterialApp(
      home: LoginScreen(authService: mockAuth),
    ));

    await tester.enterText(find.byKey(const Key('emailField')), '[email protected]');
    await tester.enterText(find.byKey(const Key('passwordField')), 'pass123');
    await tester.tap(find.byKey(const Key('loginButton')));
    await tester.pumpAndSettle();

    verify(mockAuth.login('[email protected]', 'pass123')).called(1);
  });
}
```

### Anti-Patterns

| Bad | Good | Why |
|-----|------|-----|
| No `pumpAndSettle()` after action | Always pump after interactions | Animations not complete |
| `find.text()` for dynamic text | `find.byKey()` | Locale/text changes break tests |
| Testing implementation details | Test user-facing behavior | Brittle |
| No mocking in widget tests | Mock services, repos | Tests hit real APIs |

### TestMu AI Cloud (Integration Tests)

```bash
# Run integration tests on LambdaTest real devices
# 1. Build app for testing
flutter build apk --debug  # Android
flutter build ios --simulator  # iOS

# 2. Upload to LambdaTest
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
  -X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
  -F "appFile=@build/app/outputs/flutter-apk/app-debug.apk"

# 3. Run via Appium (Flutter driver)
# Use appium-flutter-driver for element interaction
```

## Quick Reference

| Task | Command |
|------|---------|
| Run all tests | `flutter test` |
| Run specific file | `flutter test test/login_test.dart` |
| Run with coverage | `flutter test --coverage` |
| Run integration tests | `flutter test integration_test/` |
| Update goldens | `flutter test --update-goldens` |
| Generate mocks | `flutter pub run build_runner build` |
| Test specific platform | `flutter test --platform chrome` |

## pubspec.yaml

```yaml
dev_dependencies:
  flutter_test:
    sdk: flutter
  integration_test:
    sdk: flutter
  mockito: ^5.4.0
  build_runner: ^2.4.0
```

## Deep Patterns

For advanced patterns, debugging guides, CI/CD integration, and best practices,
see `reference/playbook.md`.

© TestMu AI · MIT · LambdaTest/agent-skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
flutter-add-widget-test flutter Скилл flutter-add-widget-test для Claude Code помогает писать тесты Flutter-виджетов: проверять отображение, состояние и реакцию на действия. Включается при проверке конкретного виджета. CX Codex +1 42 900установок flutter-add-integration-test flutter Скилл flutter-add-integration-test для Claude Code настраивает интеграционные тесты Flutter-приложения и превращает действия через MCP в тестовый код. Подключается при исследовании интерфейса и автоматизации пользовательских сценариев. CX Codex +1 41 500установок flutter-testing Stanislav [MADTeacher] Chernyshev Скилл flutter-testing для написания, починки и отладки тестов Flutter: юнит-, виджет- и интеграционные тесты, моки, golden-проверки. CX Codex +1 1 500установок Flutter MCP Toolkit Arenukvern MCP-сервер Flutter MCP Toolkit управляет отладочными сборками Flutter через семантические снимки, горячую перезагрузку и поиск виджетов. Пригодится при автотестах и интерактивной отладке приложений. CX Codex +1 ★ 399звёзд репо flutter-expert Seth Hobson Субагент flutter-expert для Claude Code, Codex и Cursor, специализированный на Flutter 3.x и Dart 3.x. Берёт на себя архитектуру, виджеты, управление состоянием и сборку под мобайл, веб, десктоп и встраиваемые системы. CX Codex 720установок flutter-best-practices Ivanna Kaceviča Скилл flutter-best-practices для Claude Code задаёт правила Flutter и Dart: слои, структура фич, виджеты и тесты. Агент читает нужный файл-справочник под задачу. CX Codex +1 ★ 674звёзд репо

Из того же набора47

Весь набор →
xcuitest-skill Генерирует UI-тесты на XCUITest для iOS и iPadOS приложений. Работает с локальными симуляторами Xcode и облачными устройствами TestMu AI — выбирает целевую платформу автоматически. CX Codex +1 248установок puppeteer-skill Генерирует Puppeteer-скрипты для браузерной автоматизации, скрейпинга и PDF. Срабатывает на упоминание Puppeteer, headless Chrome, page.goto, scrape. CX Codex +1 247установок testng-skill Генерирует Java-тесты для TestNG с группами, наборами данных и параллельным запуском. Настраивает тестовые suite и слушателей. CX Codex +1 243установок codeception-skill Генерирует приёмочные, функциональные и модульные BDD-тесты Codeception на PHP. Автоматизирует тестирование пользовательских сценариев и веб-страниц. CX Codex +1 243установок smartui-skill Скилл настраивает визуальные регрессионные тесты SmartUI для сравнения скриншотов. Подходит для проверки страниц и компонентов в разных браузерах и viewport. CX Codex +1 237установок jasmine-skill Генерирует тесты на Jasmine для JavaScript и TypeScript. BDD-стиль, спаи для моков, поддержка асинхронного кода — автоматически создаст describe, it, expect и spy. CX Codex +1 237установок mocha-skill Генерирует тесты Mocha для JavaScript и TypeScript с проверками Chai и моками Sinon. Охватывает модульное тестирование. CX Codex +1 235установок unittest-skill Генерирует тесты на встроенном фреймворке Python unittest с TestCase, setUp/tearDown и методами проверки. Срабатывает, когда вы упоминаете unittest, TestCase или self.assertEqual. CX Codex +1 235установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой