アプリテストフレームワークの概要

MATLAB^® アプリテストフレームワークを使用し、App Designer のアプリや関数 uifigure を用いてプログラムによってビルドしたアプリをテストします。アプリテストフレームワークでは、ボタン押下やスライダーのドラッグなどの UI コンポーネント上での動作をプログラムから実行するテストクラスの作成、およびアプリの動作検証を行うことができます。

アプリのテスト

テストの作成 – クラスベースのテストでは、matlab.uitest.TestCase をサブクラス化することによってアプリテストフレームワークを使用できます。matlab.uitest.TestCase は matlab.unittest.TestCase のサブクラスであるため、検定、フィクスチャ、およびプラグインなどのユニットテストフレームワークの機能にテストがアクセスすることができます。コマンドプロンプトでアプリテストフレームワークを試すには、matlab.uitest.TestCase.forInteractiveUse を使用してテストケースインスタンスを作成します。

テストの内容 – 通常、アプリのテストでは matlab.uitest.TestCase の press、type などの動作メソッドを使用してアプリコンポーネントをプログラム的に操作してから、その結果の検定を実行します。たとえば、チェックボックスを 1 つクリックし、その他のチェックボックスが無効になることを検証するテストなどがあります。あるいは、テキストボックスに数値を入力し、アプリの計算が予期される結果になることを検証するテストもあります。このタイプのテストでは、テストするアプリのプロパティを理解している必要があります。ボタン押下を検証するには、MATLAB がアプリオブジェクトのどこにボタンのステータスを格納するかを把握していなければなりません。計算の結果を検証するには、アプリ内の結果にアクセスする方法を把握していなければなりません。

テストのクリーンアップ – ベストプラクティスとしては、テストの後にアプリを削除する破棄アクションを含めます。通常、テストメソッドは matlab.unittest.TestCase の addTeardown メソッドを使用してこのアクションを追加します。

アプリのロック – アプリテストで Figure が作成されると、フレームワークはコンポーネントと外部の相互作用を防ぐためにその Figure を直ちにロックします。コマンドプロンプトで試すために matlab.uitest.TestCase.forInteractiveUse のインスタンスを作成する場合、アプリテストフレームワークは UI コンポーネントをロックしません。

デバッグの目的で Figure のロックを解除するには、関数 matlab.uitest.unlock を使用します。

警告の消去 – 場合によっては、アプリによってモーダル警告ダイアログボックスが表示され、アプリコンポーネントを操作できなくなります。ダイアログボックスの背後にある Figure にアクセスするには、このダイアログボックスを閉じなければならない場合があります。Figure ウィンドウで警告ダイアログボックスをプログラムにより閉じるには、dismissAlertDialog メソッドを使用します。

UI コンポーネントの動作のサポート

matlab.uitest.TestCase の動作メソッドはさまざまな UI コンポーネントをサポートしています。

コンポーネント	一般的な作成関数	`matlab.uitest.TestCase` の動作メソッド
コンポーネント	一般的な作成関数	`press`	`choose`	`drag`	`type`	`hover`	`chooseContextMenu`
座標軸	`axes`	✔		✔		✔	✔
ボタン	`uibutton`	✔					✔
ボタングループ	`uibuttongroup`		✔
チェックボックス	`uicheckbox`	✔	✔				✔
日付ピッカー	`uidatepicker`				✔		✔
離散型ノブ	`uiknob`		✔				✔
ドロップダウン	`uidropdown`		✔		✔		✔
編集フィールド (数値、テキスト)	`uieditfield`				✔		✔
イメージ	`uiimage`	✔					✔
ノブ	`uiknob`		✔	✔			✔
ラベル	`uilabel`						✔
リストボックス	`uilistbox`		✔				✔
メニュー	`uimenu`	✔
パネル	`uipanel`	✔				✔	✔
極座標軸	`polaraxes`	✔				✔	✔
プッシュツール	`uipushtool`	✔
ラジオボタン	`uiradiobutton`	✔	✔				✔
スライダー	`uislider`		✔	✔			✔
スピナー	`uispinner`	✔			✔		✔
状態ボタン	`uibutton`	✔	✔				✔
スイッチ (ロッカー、スライダー、トグル)	`uiswitch`	✔	✔				✔
タブ	`uitab`		✔
タブグループ	`uitabgroup`		✔
テーブル	`uitable`		✔		✔		✔
テキストエリア	`uitextarea`				✔		✔
トグルボタン	`uitogglebutton`	✔	✔				✔
トグルツール	`uitoggletool`	✔	✔
ツリーノード	`uitreenode`		✔				✔
UI 座標軸	`uiaxes`	✔		✔		✔	✔
UI Figure	`uifigure`	✔		✔		✔	✔

例: アプリ用テストの記述

ライブスクリプトを開く

この例では、現在のフォルダー内のアプリ用にテストを記述する方法を示します。このアプリには、プロットのサンプルサイズとカラーマップを変更するオプションが用意されています。プログラムによりアプリを操作して結果を検定するには、アプリテストフレームワークとユニットテストフレームワークを使用します。

テスト前にこのアプリのプロパティを確認するには、アプリのインスタンスを作成します。この手順はテストには必要ありませんが、テストで使用されるプロパティを確認しておくと役に立ちます。たとえば、アプリ内の [Update Plot] ボタンにアクセスするには app.UpdatePlotButton を使用します。

app = ConfigurePlotAppExample;

Figure Configure Plot contains an axes object and other objects of type uilabel, uidropdown, uibutton, uinumericeditfield. The axes object contains an object of type surface.

現在のフォルダー内の ConfigurePlotAppExampleTest.m という名前のファイルで、matlab.uitest.TestCase から派生させたテストクラスを作成します。2 つの Test メソッドを ConfigurePlotAppExampleTest クラスに追加します。各メソッドで、テストする前にアプリのインスタンスを作成し、テストの完了後にそのインスタンスを削除します。

testSampleSize メソッド — サンプルサイズを変更し、プロットを更新して、プロットが指定のサンプルサイズを使用していることを検証します。
testColormap メソッド — カラーマップを選択し、プロットを更新して、プロットが指定のカラーマップを使用していることを検証します。

classdef ConfigurePlotAppExampleTest < matlab.uitest.TestCase
    methods (Test)
        function testSampleSize(testCase)
            app = ConfigurePlotAppExample;
            testCase.addTeardown(@delete,app)

            testCase.type(app.SampleSizeEditField,12)
            testCase.press(app.UpdatePlotButton)

            ax = app.UIAxes;
            surfaceObj = ax.Children;
            testCase.verifySize(surfaceObj.ZData,[12 12])
        end

        function testColormap(testCase)
            app = ConfigurePlotAppExample;
            testCase.addTeardown(@delete,app)

            testCase.choose(app.ColormapDropDown,"Winter")
            testCase.press(app.UpdatePlotButton)

            expectedMap = winter;
            ax = app.UIAxes;
            testCase.verifyEqual(ax.Colormap,expectedMap)
        end
    end
end

テストを実行します。この例では、両方のテストにパスします。

results = runtests("ConfigurePlotAppExampleTest")

Running ConfigurePlotAppExampleTest

.
Done ConfigurePlotAppExampleTest
__________

results = 
  1×2 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   2 Passed, 0 Failed, 0 Incomplete.
   11.9555 seconds testing time.

参考

matlab.uitest.TestCase