AltUnity Tester для автоматизации Unity проектов

AltUnity Tester — это инструмент автоматизации тестирования на основе пользовательского интерфейса с открытым исходным кодом, который помогает находить объекты в вашей игре Unity и взаимодействовать с ними с помощью тестов, написанных на C #, Python или Java.

Как работает

Запускать тесты можно на реальных устройствах или в редакторе Unity. Фреймворк состоит из следующих модулей:

• Сервер AltUnity

• Драйвер AltUnity

• Окно редактора AltUnity Tester

Модуль AltUnity Server нужен, чтобы игра открывала доступ ко всем объектам в иерархии Unity. Игра открывает соединение сокета TCP на устройстве, на котором запущено приложение Unity, и ожидает подключения драйвера после запуска приложения.

Модуль драйвер AltUnity используется для подключения к серверу AltUnity, доступа ко всем объектам Unity и взаимодействия с ними посредством тестов, написанных на C #, Java или Python.

Окно редактора AltUnity Tester — это графический интерфейс, используемый для инструментовки игры Unity и запуска тестов C # непосредственно из редактора Unity.

Установка

Установка достаточна простая, устанавливается Asset Store — ссылка. Так же можно скачать через GitHub.

Далее переходим в диспетчер загрузок Asset Store из редактора Unity и импортируйте пакет в свой проект. После этого в редакторе появится меню AltUnity Tools. Через него можно открыть окно редактора, для запуска тестов.

Первый тест

В папке Editor создаем первый тест. 

Пример написан на C#.

using System.Collections.Generic; using NUnit.Framework; using Altom.AltUnityDriver; using UnityEngine;  public class FirstTest {     public AltUnityDriver altUnityDriver;     //Before any test it connects with the socket     [OneTimeSetUp]     public void SetUp()     {         altUnityDriver =new AltUnityDriver();     }      //At the end of the test closes the connection with the socket     [OneTimeTearDown]     public void TearDown()     {         altUnityDriver.Stop();     }      [Test]     public void Test()     {         //Load Scene         altUnityDriver.LoadScene("level_1");         // Find player         AltUnityObject player = altUnityDriver.FindObject(By.TAG,"Player");         // Get the health parameter         var shealth = player.GetComponentProperty("Health","health","Assembly-CSharp");         int health = int.Parse(shealth);                 while (health>= 100)         {             //Go ahead             AltUnityKeyCode kcode = AltUnityKeyCode.D;             altUnityDriver.PressKey(kcode, 3);             shealth = player.GetComponentProperty("Health","health","Assembly-CSharp");             health = int.Parse(shealth);         }      }  }

Что в нем происходит. Методы SetUp и TearDown запускают драйвер для дальнейшей работы. Метод Test собственно наш тест.  Мы загружаем нужную нам сцену, далее находим нашего игрока. Класс AltUnityObject представляет объекты в игре и позволяет взаимодействовать с ними. У игрока получаем параметр здоровье, далее пока здоровье больше 100 идем вперед.

Запуск тестов

В окне AltUnity Editor запускаем игру. Далее нажимаем Run All Tests и ждем результатов. Белый круг — игрок. Красный овал- враг. При сопрекосновении наносится урон.

Лицензия

Как писалось выше это опенсорсный инструмент. Но есть дополнительный платный инструмент AltUnity Inspector, стоит от 18$ за пользователя в месяц. Нужен для автоматизации тестов без редактора Unity. Что тоже бывает удобно.

Итоги

Инструмент довольно интересный и простой в изучении. Позволяет быстрее писать UI тесты для проектов. Так же у него хорошая поддержка и комьюнити в Discord. Советую попробовать, если задумывались над автоматизацией в Unity проектах.

P.S. Часть информации взята и переведена из официальной документации.