Unity Test RunnerのPlay Mode testsを実機上で実行する #UniteTokyo

9/25, 26に開催されたUnite Tokyo 2019の『Unity Test Runnerを活用して内部品質を向上しよう』というセッションの中で、テストはPlayer（Android端末など）でも実行できる旨をきちんとお伝えできていませんでした*1。

以下の質問をいただいたので、これに回答する形でまとめます。

ネイティブプラグインが、Test Runnerの手が届かないせいでいつもテストが書けず、仕様変更でバグが出る温床になる印象があります……
ネイティブプラグインをうまくテストしてるよっていう方、どうやってますか？#UniteTokyo
— 峅井はで (@kraihd) 2019年9月26日

なお、本セッションのスライドはすでにUnity Learning Materialsで公開中。動画は後日公開される予定です。

learning.unity3d.jp togetter.com

セッション全体のフォローアップ記事はこちら。

www.nowsprinting.com

ネイティブプラグイン自体のテストについて

いきなりオフトピですが、ネイティブプラグイン自体のテストは、C++であればGoogletestやXcodeを使ってC++のレイヤでユニットテストを書くべきです。

以下に紹介する、Unity Test RunnerのPlay Mode tests実機実行は素早く実行できるものではなく*2、Unityプロジェクトとのインテグレーション（結合・統合）を確認するためのテストケースだけに留めておくのが賢明です。

Play Mode testsをPlayer（実機）で実行する

Test Runnerウィンドウ

Play Mode testsは、Player（実機）で実行することができます。逆に言うと、Edit Mode testsは実行できません。しかし、すべてのテストを実機で実行する必要はないはずですので、一般的なロジックのテストはEdit Modeで、特別に実機でも動作させたいテスト*3のみPlay Modeで書くことをおすすめします。

ビルドターゲットを"Android"に切り替えた状態でTest RunnerウィンドウのPlayModeタブを開くと、右上に "Run all in player(Android)" と書かれたボタンが表示されます。 Android端末をUSB接続した状態でこのボタンをクリックすると、すべてのPlay ModeテストがAndroid端末上で実行されます*4。

f:id:nowsprinting:20191001091335p:plain

コマンドライン

コマンドラインからのテスト実行では、引数-testPlatformに（playmodeの代わりに）実行するBuildTarget文字列を指定することで実行できます。

特定プラットフォームでのみ実行されるテスト

「このテストコードは特定のプラットフォームでのみ実行したい」というケースがあるはずです。その場合、テストメソッドに[UnityPlatform()] アトリビュートを付与し、引数にRuntimePlatformを指定できます。

下例の場合、Test RunnerウィンドウではPlay Modeで”Run all in player(Android)”をクリックしたときのみ、コマンドラインでは引数に-testPlatform Androidを指定したときのみ実行されます。

/// <summary>
/// Android playerでのみ実行されるテスト
/// </summary>
[Test]
[UnityPlatform(RuntimePlatform.Android)]
public void RunOnlyAndroid()
{
    var platform = Application.platform;
    Assert.That(platform, Is.EqualTo(RuntimePlatform.Android));
}

なお、[UnityPlatform]アトリビュートに指定するのは、RuntimePlatformです。コマンドライン引数-testPlatformに指定するBuildTargetとは文字列が異なるものもありますので注意してください。