Unity 6 Edit Modeテスト環境構築と実行方法

2026年11月9日

広告

Unity 6では、コードの品質を向上させ、バグを早期に発見するために、テスト環境を構築することが重要です。この資料では、Unity 6のTest Runnerを使用して、テスト環境の構築と実行方法をステップバイステップで解説します。これにより、プロジェクトの品質管理を効率的に行えるようになります。


この記事で扱うテストについて

本記事では、UnityのTest Runnerを使用して、基本的なユニットテストを実行します。対象となるのは、Calculator クラスの Add メソッドで、以下のシナリオをテストします。

テスト内容: Add メソッドに 3 と 4 を渡したとき、正しい結果である 7 を返すかどうかを確認する。

このテストを通じて、Test Runnerの使い方やユニットテストの基本手順を学べます。テスト結果は Test Runner で確認できます。

TDDは「最初にテストを書き、そのテストを通過するコードを実装する」開発手法で、コードの品質向上や早期のバグ発見を目的としています。本記事では、TDDの全容を扱うわけではありませんが、TDDを実践する際の基礎知識としても有用な内容を含んでいます。

1. Test Runnerとは

Test Runnerは、Unityでユニットテストやプレイモードテストを実行するためのツールです。これを使用することで、コードの動作確認やリファクタリング時のバグ検出が容易になります。また、テストを自動化することで、コードの品質向上と保守性の向上が期待できます。

2. 初期設定と環境構築

2.1 プロジェクトの準備

  1. Unity Hubを使用して、新規プロジェクトを作成します。(EditModeTestSample)
  2. 任意のテンプレートを選択(例: Universal Render Pipeline)。

Calculator の足し算を Edit Mode で確かめる

Assets/Scripts/Calculator に CalculatorAsm.asmdef を作り、同じフォルダーに次の Calculator.cs を保存します。

public class Calculator
{
    public int Add(int a, int b) => a + b;
}

Window > General > Test Runner を開いて EditMode タブを選びます。テストアセンブリ用フォルダーを作成し、生成されたアセンブリが Editor 専用であることを確認します。その .asmdef の Assembly Definition References に CalculatorAsm を追加して Apply を押します。フォルダーの作成とテストスクリプトの作成は別の操作です。テスト用フォルダーに CalculatorTests.cs を保存します。

using NUnit.Framework;

public class CalculatorTests
{
    [TestCase(3, 4, 7)]
    [TestCase(-3, 4, 1)]
    [TestCase(-3, -4, -7)]
    public void Add_ReturnsExpectedSum(int a, int b, int expected)
    {
        var calculator = new Calculator();
        Assert.That(calculator.Add(a, b), Is.EqualTo(expected));
    }
}

[TestCase] の一行が一つの入力例です。EditMode タブで CalculatorTests を選び、Run Selected で3ケースの結果を確認します。たとえば最初の期待値を一時的に 8 に変えると、そのケースだけが失敗します。失敗の詳細で期待値と実際の値を読み取ったら、7 に戻して再実行します。テストが一覧に出ないときは、Console のコンパイルエラー、スクリプトの所属フォルダー、テストアセンブリの参照を順に確認してください。

Unity 6.6 初めてテストを実行する · アセンブリ定義の補足

アセンブリ定義に関する解説

訪問数 281 回, 今日の訪問数 1回

広告

C#,Test,Unity

Posted by hidepon