Windows デスクトップ E2E テスト

pywinauto と Windows UI Automation（UIA）を使用したWindowsネイティブデスクトップアプリケーションのエンドツーエンドテスト。WPF、WinForms、Win32/MFC、Qt（5.x / 6.x）をカバーし、Qt固有のガイダンスは専用セクションとして提供します。

アクティベートするタイミング

• Windowsネイティブデスクトップアプリケーションのエンドツーエンドテストを書くまたは実行するとき
• デスクトップGUIテストスイートをゼロから設定するとき
• 不安定または失敗するデスクトップオートメーションテストを診断するとき
• 既存のアプリにテスタビリティ（AutomationId、アクセシブルな名前）を追加するとき
• デスクトップエンドツーエンドをCI/CDパイプライン（GitHub Actions windows-latest）に統合するとき

使用しないタイミング

• Webアプリケーション → e2e-testing スキル（Playwright）を使用する
• Electron / CEF / WebView2 アプリ → HTMLレイヤーにはUIAではなくブラウザオートメーションが必要
• モバイルアプリ → プラットフォーム固有のツールを使用する（UIAutomator、XCUITest）
• 実行中のGUIを必要としない純粋なユニットまたは統合テスト

コアコンセプト

すべてのWindowsデスクトップオートメーションは**UI Automation（UIA）**に依存します。これはWindowsに組み込まれたアクセシビリティAPIです。サポートされているすべてのフレームワークは、読み取りおよび操作可能なプロパティを持つUIA要素のツリーを公開します：

テスト（Python）
    └── pywinauto（UIAバックエンド）
        └── Windows UI Automation API   ← Windowsに組み込み、フレームワーク非依存
            └── アプリのUIAプロバイダー      ← 各フレームワークが独自に実装
                └── 実行中の .exe

フレームワーク別UIA品質：

フレームワーク	AutomationId	信頼性	注記
WPF	5/5	優秀	x:Name が直接AutomationIdにマッピング
WinForms	4/5	良好	…