test-flutter

name	test-flutter
description	Flutter App のテスト実行・静的解析・フォーマット・テスト記述ガイド
disable-model-invocation	true
allowed-tools	Bash(flutter:*), Bash(dart:*), Read, Glob, Grep

Flutter App テスト

実行手順

以下を順番に実行し、全てパスすることを確認する。

1. 静的解析

dart analyze apps/mobile

warning 以上は修正する。info レベルは必要に応じて対応。

MCP代替: mcp__dart-mcp__analyze_files でも実行可能だが、CLI推奨。

2. フォーマット

dart format apps/mobile

3. ユニットテスト

cd apps/mobile && flutter test

特定ファイルのみ:

cd apps/mobile && flutter test test/<filename>_test.dart

MCP代替: mcp__dart-mcp__run_tests でも実行可能だが、CLI推奨。 MCP版はDTD接続不要な操作のため、CLIの方が効率的。

テスト記述規約

ファイル配置・命名

• テストファイルは apps/mobile/test/ に配置
• 命名: <対象の概念>_test.dart
  • ウィジェットテスト例: approval_bar_test.dart, chat_input_bar_test.dart
  • ロジックテスト例: chat_message_handler_test.dart

import

import 'package:flutter_test/flutter_test.dart';
import 'package:ccpocket/...';

テスト構造

void main() {
  group('対象クラスまたは機能', () {
    test('動作の説明', () {
      // ロジックテスト
      expect(actual, expected);
    });

    testWidgets('UI動作の説明', (tester) async {
      // ウィジェットテスト
      await tester.pumpWidget(MaterialApp(home: TargetWidget()));
      expect(find.text('expected'), findsOneWidget);
    });
  });
}

• group で対象機能ごとにグルーピング
• ロジックテストは test()、UI テストは testWidgets() を使い分ける
• setUp() でテスト前の共通初期化を行う

テスト対象の方針

• ウィジェットテスト: 画面の表示・インタラクション検証
  • pumpWidget でウィジェット構築 → find で要素確認 → tap/enterText で操作
• ロジックテスト: サービス・ハンドラーの振る舞い検証
  • 純粋なDartクラスのメソッド呼び出しと結果確認
• WebSocket通信やBridge接続のモックが必要なテストは避ける (E2E領域)

既存テストファイル一覧

• approval_bar_test.dart — 承認バーUI
• ask_user_question_widget_test.dart — AskUserQuestion UI
• chat_input_bar_test.dart — チャット入力バーUI
• chat_message_handler_test.dart — メッセージハンドラーロジック
• gallery_screen_test.dart — ギャラリー画面
• home_screen_test.dart — ホーム画面
• plan_mode_test.dart — プランモードUI
• session_card_test.dart — セッションカードUI
• slash_command_test.dart — スラッシュコマンドUI
• tool_result_bubble_test.dart — ツール結果表示
• tool_use_tile_test.dart — ツール使用タイル表示