【入門編】【上級者向け】VB.NETのWPFアプリにおけるUI自動テスト(FlaUI / TestStack.White)の導入とCI/CDパイプライン構築 – Visual Basic (VB / VB.NET)解析バイブル

スポンサーリンク
スポンサーリンク

マクロの記録から、真の自動化エンジニアへ。VB.NET × WPF で構築する「壊れないUI」の防衛線

こんにちは。技術の深淵へようこそ。

「ボタンをクリックするだけのマクロを作ったはずなのに、画面のデザインを少し変えただけで動かなくなった……」
「修正した箇所が、実は別の場所を壊していた(デグレード)ことに、数週間後に気づいた……」

もしあなたがそんな経験をしているなら、おめでとうございます。あなたは今、「自動化の壁」にぶつかっています。そして、その壁を乗り越えた先にこそ、世界中のエンジニアが憧れる「堅牢なソフトウェア開発」の世界が待っています。

今日は、VB.NETを使ってモダンなUI(WPF)を構築し、それをFlaUIという強力な武器を使って自動テストし、さらにはCI/CDという仕組みで「人間が寝ている間も品質を監視する」仕組みを作る方法を伝授します。

「マクロの記録」という魔法から卒業し、エンジニアとしての「設計力」を手に入れましょう。

1. なぜ「マクロの記録」ではいけないのか?

多くの人が最初に通る道が、ツールによる「操作の記録」です。しかし、これは非常に脆(もろ)いものです。

記録されたマクロの弱点

  • 座標依存: 「画面のここをクリック」という命令は、解像度が変わると死にます。
  • 名前依存: 「『保存』という名前のボタン」を探す命令は、ボタンの名前を「保存する」に変えた瞬間に死にます。

これでは、仕様変更が頻繁なモダンな開発現場では、テストコードを書くこと自体が「メンテナンス地獄」になってしまいます。

解決策:AutomationId(自動化ID)の概念

プロフェッショナルは、ボタンの「見た目」ではなく、「内部的な識別子」をターゲットにします。WPF(XAML)には、そのための`AutomationId`というプロパティが用意されています。

これを使えば、ボタンのデザインが青から赤に変わろうが、テキストが「送信」から「OK」に変わろうが、テストコードは揺らぎません。ここが、「壊れないテスト」を書くための第一歩です。

2. 準備:WPFアプリに「テスト用の目」を授ける

まずは、テスト対象となるシンプルなWPFアプリケーション(VB.NET)を想定しましょう。

XAMLでの実装(ここが重要!)

`AutomationId`を明示的に指定するのが、プロの作法です。

<!-- MainWindow.xaml -->
<Window x:Class="MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="My Modern App" Height="200" Width="300">
    <StackPanel Margin="20">
        <!-- AutomationIdを付与することで、テストコードから確実に特定できる -->
        <TextBox x:Name="InputBox" 
                 AutomationId="UserNameInput" 
                 Margin="0,0,0,10" />
        
        <Button x:Name="SubmitButton" 
                Content="ログイン" 
                AutomationId="LoginButton" 
                Click="SubmitButton_Click" />
        
        <TextBlock x:Name="StatusText" 
                   AutomationId="StatusMessage" 
                   Text="待機中..." 
                   Margin="0,10,0,0" />
    </StackPanel>
</Window>

3. 実践:FlaUIによるUI自動テストの記述

次に、テストコードを書いていきましょう。以前は`TestStack.White`が主流でしたが、現在はよりモダンで高速なFlaUIを使うのが業界のスタンダードです。

テストプロジェクトの構築

Visual Studioで「MSTest」または「NUnit」のプロジェクトを新規作成し、NuGetパッケージマネージャーから `FlaUI.UIA3` をインストールしてください。

テストコード(VB.NET)

さあ、魂を込めたコードを見ていきましょう。

Imports FlaUI.Core
Imports FlaUI.UIA3
Imports Microsoft.VisualStudio.TestTools.UnitTesting

<TestClass>
Public Class LoginUITests
    
    Private _app As Application
    Private _automation As UIA3Automation

    <TestInitialize>
    Public Sub Setup()
        ' 1. アプリケーションを起動する
        ' Pathは実際の実行ファイル (.exe) のパスを指定してください
        _app = Application.Launch("YourWpfApp.exe")
        
        ' 2. UI Automationエンジンを初期化
        _automation = New UIA3Automation()
    End Sub

    <TestMethod>
    Public Sub Test_LoginProcess_Success()
        ' 3. メインウィンドウを取得
        Dim window = _app.GetMainWindow(_automation)
        Assert.IsNotNull(window, "ウィンドウが見つかりませんでした。")

        ' 4. AutomationIdを使って要素を特定する(ここが極めて重要!)
        ' 座標ではなく、IDで探すから、デザイン変更に強い!
        Dim inputField = window.FindFirstDescendant(Function(f) f.AutomationId = "UserNameInput").AsTextBox()
        Dim loginButton = window.FindFirstDescendant(Function(f) f.AutomationId = "LoginButton").AsButton()
        Dim statusLabel = window.FindFirstDescendant(Function(f) f.AutomationId = "StatusMessage").AsLabel()

        ' 5. 操作の実行
        inputField.Enter("Legendary_Engineer") ' テキストを入力
        loginButton.Click()                    ' ボタンをクリック

        ' 6. 結果の検証(Assertion)
        ' 期待される状態(StatusTextが「ログイン成功」になること)を確認
        ' UIの更新にはわずかな時間がかかることがあるため、少し待機するか、Retryロジックを入れるのがコツ
        Assert.AreEqual("ログイン成功", statusLabel.Text, "ログイン後のステータス表示が正しくありません。")
    End Sub

    <TestCleanup>
    Public Sub Teardown()
        ' 7. 後片付け:テストが終わったらアプリを閉じる
        _automation.Dispose()
        _app.Close()
    End Sub
End Class

コードのポイント解説

  • `FindFirstDescendant`: これは「ツリーの中から、指定した条件に合う子孫を探せ」という命令です。
  • `AsTextBox()` / `AsButton()`: 見つけた要素を、特定の型(テキストボックス型、ボタン型)にキャストしています。これにより、`Enter()` や `Click()` といった、その要素特有のメソッドが使えるようになります。
  • `TestInitialize` / `TestCleanup`: テストの「前処理」と「後処理」です。テストごとにアプリをクリーンな状態で起動させるために必須の儀式です。

4. 究極の到達点:CI/CDパイプラインへの組み込み

テストコードを書いただけでは、まだ半分です。真のプロフェッショナルは、「人間がテストを実行すること」すら自動化します。

CI/CDとは?

継続的インテグレーション(CI)とは、コードが変更されるたびに、自動でビルドし、自動でテストを実行する仕組みのことです。

実装のイメージ(GitHub Actionsの場合)

例えば、GitHubにコードをPushすると、クラウド上のサーバーが自動で動き出し、以下を実行します。

1. Build: VB.NETのコードをコンパイルして `.exe` を作る。
2. Test: さきほど書いたFlaUIのテストを実行する。
3. Report: テストが成功したら「合格」、失敗したら「開発者に通知」する。

注意点(アーキテクトの助言):
UIテストは「画面」を必要とするため、クラウド上のサーバー(Headless環境)で動かすには少しコツがいります。Windowsのセッションが立ち上がっていない環境では、GUI操作ができません。そのため、「Self-hosted Runner」(自分のPCや専用のWindowsマシンを、GitHubの実行マシンとして登録する手法)を使うのが、現場での現実的な解となります。

まとめ:ここをクリアすれば、あなたはもう「初級者」ではない

今回の内容を振り返りましょう。

1. `AutomationId` を活用せよ: 見た目に依存せず、論理的なIDで要素を掴む。
2. FlaUI を使いこなせ: 座標ではなく、UIツリーを探索する。
3. テストを「仕組み」に組み込め: CI/CDによって、品質を自動防衛する。

これらは、単なるプログラミングのテクニックではありません。「変化に強いシステムをどう作るか」という設計思想そのものです。

最初はエラーの山に悩まされるかもしれません。要素が見つからない、アプリが起動しない……。でも、それこそが成長の種です。エラーログを読み解き、UIツリーの構造を理解していけば、あなたは必ず「自動化の達人」になれます。

さあ、恐れずにコードを書き始めましょう。応援していますよ!

タイトルとURLをコピーしました