FAQ

On what platforms can I run tests with AltTester Unity SDK?
PC, Mac, Android, iOS and Unity Editor; support for WebGL and Consoles is work in progress.

What programming language can I use to write tests?
C#, Python and Java.

Can AltTester Unity SDK be integrated with Appium?
Yes, AltTester Unity SDK can be used alongside Appium. Appium allows you to access the native objects and AltTester Unity SDK can be used to access the Unity objects. For more info regarding how to run tests together with appium check Running tests together with Appium.

What versions of Unity does AltTester Unity SDK work with?
AltTester Unity SDK works with Unity 2018.1 or higher. If you encounter any issues we'd like to hear about them. You can raise an issue or join our community on Discord or Google Groups.

Can I use AltTester Unity SDK to run tests using device cloud services?
It works with some of the cloud services. We tried it with Bitbar Cloud and AWS Device Farm. These give you access to a virtual machine or a Docker container that has a cloud device attached, where you upload your tests, configure your environment and run your tests. More info about this here: Running tests using device cloud services.

Do I need access to the source code of the Unity App to write tests?
In order to run tests using AltTester Unity SDK you require an instrumented build of the Unity App. To create an instrumented build of the Unity App you need to import the AltTester package in Unity Editor.

I don’t have access to source code, but I do have access to an instrumented build. How can I begin to write tests?
We’ve published AltTester Desktop, which allows you to inspect the game objects outside the unity editor without access to the source code. More information about AltTester Desktop can be found in this documentation.

Troubleshooting

I get `waiting for connection on port 13000` popup message when i start my Unity App
The popup message shows up when you start your instrumented Unity App. It tells you that the AltTester Unity SDK is ready and you can start running your tests.

Why do I get an error when trying to call the port forwarding methods?
You need to make sure the following third party tools are installed: ADB - Android or iproxy - iOS. For more information you can check our setup port forwarding guide.

I get the error: Multiple precompiled assemblies with the same name Newtonsoft.Json.dll included or the current platform.
You get this error due to multiple imports of Newtonsoft.Json.dll library. You can remove the Newtonsoft.Json version from AltTester Unity SDK by deleting the Newtonsonft folder Assets/AltTester/3rdParty/Newtonsonft.

I get the error: The type or namespace name 'Newtonsoft' could not be found (are you missing a using directive or an assembly reference?),
You get this error because you don't have a reference to Newtonsoft.Json package.
Add `"com.unity.nuget.newtonsoft-json": "3.0.1"` to your project `manifest.json`, inside `dependencies`.
{
    "dependencies": {
        "com.unity.nuget.newtonsoft-json": "3.0.1"
    }
}

I get the error: The type or namespace name 'InputTestFixture' could not be found (are you missing a using directive or an assembly reference?),
You get this error because you don't have `com.unity.inputsystem` added as a testables dependency.
Add `"com.unity.inputsystem"` to your `manifest.json`, inside `testables.`
{
    "testables": [
        "com.unity.inputsystem"
  ]
}

How can I use the Input from AltTester Unity SDK if my project is using Assembly Definitions ?
To use the Input from AltTester Unity SDK you have to:
  1. Create .asmdef files in these directories (3rdParty, AltDriver, AltServer)

  2. Reference other assemblies in AltServer assembly

  3. Reference AltServer assembly in Project-Main-Assembly


I get the error: Error while running command: iproxy 13000 13000

If the inner exception is:

System.ComponentModel.Win32Exception : ApplicationName=’iproxy’, CommandLine=’13000 13000’, CurrentDirectory=’’, Native error= Cannot find the specified file

Pass the full path of iproxy to AltPortForwarding.ForwardIos


I downloaded the AltTester package v1.7.2 from the documentation on MacOS. I got a warning pop-up about the input system where I chose 'Yes' because I am using the New Input System. After reopening Unity Editor, AltTester Unity SDK is missing.

After reopening Unity Editor, add again the AltTester package in your project.