[C#] テスト自動化ライブラリFriendlyを試す – 端くれプログラマの備忘録

Windowsアプリのテスト自動化ツールを探していたらFriendlyというオープンソースのライブラリが見つかった。どういう仕組みで動くのか試してみたい。このライブラリに言及した記事を探したら以下がヒット。書かれたのは2014年と古い記事なので、この記事をなぞって自分で試してみる。

Friendlyエバンジェリストはミニスカサンタ – xin9le.net
http://blog.xin9le.net/entry/2014/12/22/000057

なお、本家リポジトリはこちら。

GitHub – Codeer-Software/Friendly
https://github.com/Codeer-Software/Friendly

SampleApp (ターゲットアプリ) 作成

– Windows Form App (.NET Framework)
– テスト用にプロパティとメソッドを追加

Form1.cs

namespace SampleApp
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }
        private readonly string xMas = "Hello there!";
        private static string GetNow() => "Current time is &#92;{DateTime.Now}.";
    }
}

namespace SampleApp

{

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent();

}

private readonly string xMas = "Hello there!";

private static string GetNow() => "Current time is \{DateTime.Now}.";

}

TestApp (テストアプリ) 作成

– Console App (.NET Framework)
– Manage NuGet Packages…
– Codeer.Friendly by Codeer v.2.5.2
– Codeer.Friendly.Windows by Codeer v.2.9.0

Program.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Diagnostics;
using System.Drawing;
using System.Reflection;
using System.Windows.Forms;
// Codeer
// https://www.codeer.co.jp/
using Codeer.Friendly.Dynamic;
using Codeer.Friendly.Windows;
namespace TestApp
{
    class Program
    {
        // Friendlyを使ったテスト自動化
        // 参考サイト:
        // Friendlyエバンジェリストはミニスカサンタ - xin9le.net
        // http://blog.xin9le.net/entry/2014/12/22/000057
        static void Main(string[] args)
        {
            //--- プロセス起動
            var path = @"D:\\Visual Studio  2017\\Projects\\SampleApp\\SampleApp\\bin\\Debug\\SampleApp.exe";
            var process = Process.Start(path);
            //--- プロセスにアタッチ
            var targetApp = new WindowsAppFriend(process);
            //--- staticメソッドの呼び出し
            var now = targetApp.Type("SampleApp.Form1").GetNow();
            Console.WriteLine(now);
            //--- プロパティの参照
            var form = targetApp.Type<Application>().OpenForms[0];
            Console.WriteLine(form.Text);
            //--- プロパティの編集
            form.BackColor = Color.LightPink;
            //--- private変数の参照
            Console.WriteLine(form.xMas);
            //--- ComboBoxを動的に追加
            //var comboBox = targetApp.Type<ComboBox>()();
            //comboBox.Items.Add("xin9le");
            //comboBox.Items.Add("ナオキ");
            //comboBox.Items.Add("緑のタイツ");
            //form.Controls.Add(comboBox);
            //--- 追加したComboBoxから値を取得
            //Console.WriteLine(comboBox.SelectedItem);
            //--- dllインジェクション
            //WindowsAppExpander.LoadAssembly(targetApp,  Assembly.GetExecutingAssembly());
            //targetApp.Type(typeof(Program)).ShowMessageBox();  //--- 相手プロセス上で以下に定義したメソッドを呼び出す
            Console.ReadKey();
            //--- 終了
            process.CloseMainWindow();
            process.WaitForExit();
        }
    }
}

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Threading.Tasks;

using System.Diagnostics;

using System.Drawing;

using System.Reflection;

using System.Windows.Forms;

// Codeer

// https://www.codeer.co.jp/

using Codeer.Friendly.Dynamic;

using Codeer.Friendly.Windows;

namespace TestApp

{

class Program

{

// Friendlyを使ったテスト自動化

// 参考サイト:

// Friendlyエバンジェリストはミニスカサンタ - xin9le.net

// http://blog.xin9le.net/entry/2014/12/22/000057

static void Main(string[] args)

{

//--- プロセス起動

var path = @"D:\\Visual Studio 2017\\Projects\\SampleApp\\SampleApp\\bin\\Debug\\SampleApp.exe";

var process = Process.Start(path);

//--- プロセスにアタッチ

var targetApp = new WindowsAppFriend(process);

//--- staticメソッドの呼び出し

var now = targetApp.Type("SampleApp.Form1").GetNow();

Console.WriteLine(now);

//--- プロパティの参照

var form = targetApp.Type<Application>().OpenForms[0];

Console.WriteLine(form.Text);

//--- プロパティの編集

form.BackColor = Color.LightPink;

//--- private変数の参照

Console.WriteLine(form.xMas);

//--- ComboBoxを動的に追加

//var comboBox = targetApp.Type<ComboBox>()();

//comboBox.Items.Add("xin9le");

//comboBox.Items.Add("ナオキ");

//comboBox.Items.Add("緑のタイツ");

//form.Controls.Add(comboBox);

//--- 追加したComboBoxから値を取得

//Console.WriteLine(comboBox.SelectedItem);

//--- dllインジェクション

//WindowsAppExpander.LoadAssembly(targetApp, Assembly.GetExecutingAssembly());

//targetApp.Type(typeof(Program)).ShowMessageBox(); //--- 相手プロセス上で以下に定義したメソッドを呼び出す

Console.ReadKey();

//--- 終了

process.CloseMainWindow();

process.WaitForExit();

}

ビルドして実行。TestAppからSampleAppのプロパティにアクセスしたり、メソッドを呼び出すことができた。そういう風にして外部アプリからターゲットアプリを操作して自動テストを行う仕組みらしい。

商用ツールにはテストケースをUIを使って定義できるものがあるが数十万円のコストがかかる。それに対して、Friendlyはテストケースをコーディングする手間がかかるけどオープンソースなので無料で使える。役立つシーンはありそうだ。

SampleApp (ターゲットアプリ) 作成

TestApp (テストアプリ) 作成

関連記事