Prerequisite

1. Download and install .NET SDK
2. Have a game instrumented with AltTester Unity SDK
3. Have AltTester Desktop app installed (to be able to inspect game)

Tests created with NUnit & AltTester-Driver for a game developed w/ Unity (TrashCat)

This repository is a test project that uses NUnit as the test library. It was generated using following command (as suggested in documentation)

dotnet new nunit

AltTester Unity SDK framework contains AltDriver class used to connect to the instrumented game developed w/ Unity. AltTester-Driver for C# is available as a nuget package. Install AltTester-Driver nuget package

dotnet add package AltTester-Driver --version 2.0.0

Run tests manually (with dotnet CLI)

1. Launch game
2. From TrashCat.Tests execute all tests:

dotnet test

! Make sure to have the AltTester Desktop App closed, otherwise the test won't be able to connect to proper port.

Run all tests from a specific class / file

dotnet test --filter <test_class_name>

Run only one test from a class

dotnet test --filter <test_class_name>.<test_name>

Used the following AltObject methods which interact with components (methods, fields, properties)

• CallComponentMethod
• GetComponentProperty
• SetComponentProperty
• GetText
• SetText
• GetParent
• UpdateObject
• Tap
• Click
• PointerDownFromObject
• PointerUpFromObject
• PointerEnterObject
• PointerExitObject
• GetWorldPosition
• GetScreenPosition
• WaitForComponentProperty it's not implemented for 1.8.2, will be available in future
• GetAllComponents
• GetAllProperties
• GetAllFields
• GetAllMethods

Used the following AltDriver > Find Objects methods

• FindObject
• By-Selector
  • By.NAME
  • By.PATH
  • By.TAG
  • By.COMPONENT
  • By.TEXT
  • By.ID
  • By.LAYER
• FindObjects
• FindObjectWhichContains
• FindObjectsWhichContain
• FindObjectAtCoordinates
• GetAllElements
• WaitForObject
• WaitForObjectWhichContains
• WaitForObjectNotBePresent

Used the following AltDriver > Unity Commands methods

• CallStaticMethod
• GetStaticProperty
• SetStaticProperty
• GetTimeScale
• SetTimeScale
• GetApplicationScreenSize
• WaitForCurrentSceneToBe
• GetAllLoadedScenes
• UnloadScene
• LoadScene
• GetCurrentScene
• PlayerPrefKeyType
• GettingPlayerPrefs
  • GetIntKeyPlayerPref
  • GetStringKeyPlayerPref
  • GetFloatKeyPlayerPref
• SettingPlayerPrefs
  • SetKeyPlayerPref(Int)
  • SetKeyPlayerPref(String)
  • SetKeyPlayerPref(Float)
• DeleteKeyPlayerPref
• DeletePlayerPref

Used the following AltDriver methods

• GetPNGScreenshot
• GetServerVersion
• GetAllScenes
• GetAllCameras
• GetAllActiveCameras

Workaround for being able to use SDK 1.8.2 installed as package in project:

• get altwebsocket-sharp.dll from here and put in project's bin\Debug\net7.0

this was necessary due to currently open issue