マクロの記録から、真の自動化エンジニアへ。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ツリーの構造を理解していけば、あなたは必ず「自動化の達人」になれます。
さあ、恐れずにコードを書き始めましょう。応援していますよ!
