【Visual Studio】WADのサンプルプログラムを動かしてみよう

今回は、Windows Application Driver（WAD） のサンプルプログラムを Visual Studio で実行してみる方法を記載します。

本記事の前提条件

• OSは、Windows 10 であること
  • これは、WADが「Windows10で自動化を行うことを前提に作られたDriver」であるため
• インストール時に、VisualStudio で以下の環境が整っていること
  • ワークロードで、「.Net デスクトップ開発」（C#での基本的な実装環境）がインストールされていること
  • 個別のコンポーネントで、必要な「.Net Framework SDK」がインストールされていること
• inspect.exe（WindowsSDK）が存在していること
  • 「C:\Program Files (x86)\Windows Kits\10\bin\”SDKのバージョン”\x64」を確認し、「inspect.exe」が存在していること
  • Visual Studioをインストールしていれば、通常存在しているはずです

サンプルプログラムの試行方法

上記手順で、スクリプトの実行はできますが、正常に計算機が動作することはありません。これには、2つの理由があります。

理由①：一部設定が不正である

理由②：スクリプトで参照している計算機のパーツが正しくない

それぞれの解決方法を記載します。

理由①の解決

1. [ツール] > [オプション] > [テスト]を開く
2. 「パフォーマンスを向上させるため、テスト アセンブリ フォルダーにあるか、runsettingsファイルに指定されているテスト アダプターのみを使用してください」のチェックを外す

理由②の解決

直接の原因は、指定しているボタン名が、英語版のWindows OS がベースになっていることにあります。そのため、指定しているパーツの名称が日本語版の「電卓」では指定したボタンが見つからずに失敗しています。

一例として、Addition（加算）のスクリプトで修正します。

実際のスクリプトは以下になっています。

public void Addition()
{
Find the buttons by their names and click them in sequence to perform 1 + 7 = 8
session.FindElementByName(“One”).Click();
session.FindElementByName(“Plus”).Click();
session.FindElementByName(“Seven”).Click();
session.FindElementByName(“Equals”).Click();
Assert.AreEqual(“8”, GetCalculatorResultText());
}

このスクリプトの中でパーツ名を示しているのは、「One」「Plus」「Seven」「Equals」の４つになります。これらを修正する必要があります。

日本語版のIDを調べるには、inspect.exe（前提条件に記載）もしくは「UI Recorder」を使用します。「UI Recorder」は、こちらにインストーラーがあります。「WinAppDriver UI Recorder」で検索してみて下さい。

実際には、inspect を起動して、IDを知りたい場所にマウスオーバー（マウスカーソルを持っていく）を行います。すると、以下の画像（画像では「＝」）のように、その場所の情報が inspect 上に表示されます。その情報の中で、Nameの情報を拾ってくれば良いです。

以下に、上記方法で日本語版のIDに変更したスクリプトを記載します。以下のように変更してみて下さい。

public void Addition()
{
Find the buttons by their names and click them in sequence to perform 1 + 7 = 8
session.FindElementByName(“1”).Click();
session.FindElementByName(“プラス”).Click();
session.FindElementByName(“7”).Click();
session.FindElementByName(“等号”).Click();
Assert.AreEqual(“8”, GetCalculatorResultText());
}

なお、今回は、スクリプトで「FindElementByName」を使用しているため、Nameを拾っています。持ってきたい情報によって利用する情報も変わるので、注意してください。

例えば、Division（除算）のスクリプトでは、「FindElementByName」の代わりに、「FindElementByAccessibilityId」を使用しています。この場合は「AutomationID」を拾ってください。

Multiplication（乗算）とSubtraction（減算）では、「FindElementByXPath」を使用しています。この場合は「UI Recorder」を使用した方が操作が容易になると思います。取得した場合は、以下のようになります。なお、「//」でコメントとしている箇所が元のスクリプトになります。直後の一文に変更しましょう。

public void Multiplication()
{
// Find the buttons by their names using XPath and click them in sequence to perform 9 x 9 = 81
//session.FindElementByXPath(“//Button[@Name=’Nine’]”).Click();
//session.FindElementByXPath(“//Button[@Name=’Multiply by’]”).Click();
//session.FindElementByXPath(“//Button[@Name=’Nine’]”).Click();
//session.FindElementByXPath(“//Button[@Name=’Equals’]”).Click();
//Assert.AreEqual(“81”, GetCalculatorResultText());

session.FindElementByXPath(“//Button[@Name=’9′]”).Click();
session.FindElementByXPath(“//Button[@Name=’乗算’]”).Click();
session.FindElementByXPath(“//Button[@Name=’9′]”).Click();
session.FindElementByXPath(“//Button[@Name=’等号’]”).Click();
Assert.AreEqual(“81”, GetCalculatorResultText());
}

これらの他にも、以下の変更が必要です。

最初に表示されているスイッチをリセットするための「Clearメソッド」、および 計算結果のテキストフィールドの結果から余計な文字列を排除する「GetCalculatorResltTextメソッド」では 以下のような変更をしてみて下さい。こちらも「//」でコメントとしている箇所が元のスクリプトになります。

public void Clear()
{
// session.FindElementByName(“Clear”).Click();

session.FindElementByName(“クリア”).Click();
Assert.AreEqual(“0”, GetCalculatorResultText());
}

private string GetCalculatorResultText()
{
//return calculatorResult.Text.Replace(“Display is”, string.Empty).Trim();

return calculatorResult.Text.Replace(“表示は “, string.Empty).Replace(” です”, string.Empty).Trim();
}

デバッグ（プログラムの試行／バグ修正）の手順

【補足】おすすめ設定

行番号の表示

特に「デバッグ（バグの修正）を行う時」「誰かにレビュー（確認）してもらう時」などは、非常に効率が良いでしょう。どこの行のことを言っているのかが一目瞭然です。

設定手順は以下になります。

1. [ツール] > [オプション] を開く
2. ツリーエリアで、[テキスト エディター] > [すべての言語] > [一般] を選択する
3. 「行番号」にチェックを入れる