Arium is an automation testing framework for 3D applications built on top of Unity. It helps the Developers/QA to run functional tests on 3D apps on any platforms. ie., Unity Editor,Android,UWP etc…
Arium comes with the basic Unity interactions:
© 2020 ThoughtWorks, Inc.
Maintained by ThoughtWorks
- Neelarghya Mandal (Contributors)
- Jayachandran S (Contributors)
- Raju Kandaswamy (Reviewer)
- Kuldeep Singh (Reviewer)
- Download Arium Unity Package https://github.com/xrpractice/Arium/releases
- Open your Unity project which needs to be automated.
- Double click on the downloaded Unity package.
- Select all and click on Import Button.
Running Sample Test cases:
- Open UnitySampleScene in the project hierarchy - Samples >> AriumSample >> Scenes >> UnitySampleScene.
- Open Unity Build settings - File >> Build Settings
- Click on Add Open Scenes. Note: Make sure the UnitySampleScene is selected
- Close Unity build settings window
- Open TestRunner window in Unity - Window >> General >> TestRunner.
- Expand the Arium hierarchy in the Test Runner - Arium >> AriumSampleTests.dll >> Samples >> AriumSample >> UnityTestRunner
- Select PlayMode Tests and Right click on UnityTestRunner and Click on RUN.
- Test Cases will start executing and results will be displayed on the TestRunner.
To use Arium framework, Arium should be instantiated inside the test class as mentioned below
Arium _arium = new Arium();
To find a Gameobject from the Unity Scene hierarchy using its name.
String - Name of the Gameobject.
To retrieve the components attached to a GameObject
_arium.GetComponent<Name of the component here>(Name of the GameObject here)
String - Name of the Gameobject. UnityComponent - UnityComponent type
To interact with the UnityGameobjects on runtime.
To click on a particular gameobject.
_arium.PerformAction(new UnityPointerClick(), "Name of the gameobject here");
Intercation - Type of the interaction need to performed on a gameobject, in this case it is UnityPointerClick() String - Name of the Gameobject.