Run automated Unity game tests on real devices in the cloud using AltTester Unity SDK. This repository contains examples for multiple cloud device providers, each on its own branch.
All examples use the TrashCat sample game with C#/NUnit tests and the Page Object Model pattern.
| Cloud Provider | Branch | Description |
|---|---|---|
| BrowserStack | browserstack-example |
Run tests on BrowserStack real devices using BrowserStackLocal tunnel |
| BrowserStack + App Percy | browserstack-app-percy-example |
BrowserStack with visual regression testing via App Percy |
| BrowserStack WebGL | browserstack_webGL |
Run WebGL build tests on BrowserStack |
| Sauce Labs | saucelabs_example |
Run tests on Sauce Labs real devices |
| TestMu AI (LambdaTest) | testmu-ai-example |
Run tests on LambdaTest real devices with automatic tunnel management |
| TestMu AI - Python | testmu-ai-python-example |
Python/pytest version of the TestMu AI example |
┌──────────────┐ Secure Tunnel ┌──────────────────────┐
│ Your Machine│◄──────────────────────────► │ Cloud Provider │
│ │ │ │
│ NUnit Tests │ Appium (launch/manage) │ Real Device │
│ AltDriver │───────────────────────────► │ TrashCat app │
│ Tunnel │ AltTester (port 13000) │ (instrumented with │
│ │◄──────────────────────────► │ AltTester SDK) │
└──────────────┘ └──────────────────────┘
- Appium installs and launches the app on a cloud device
- A secure tunnel connects your machine to the cloud device so AltDriver can communicate with the AltTester SDK inside the app over port 13000
- AltDriver drives the game UI: find objects, tap, swipe, check state, etc.
- Pick a cloud provider from the table above
- Switch to that branch
- Follow the README in that branch for setup instructions
Each branch contains:
- Full test suite (pages + tests)
- Cloud-specific
BaseTest.cswith tunnel and driver setup - GitHub Actions CI workflow
- Provider-specific README with prerequisites and quick start guide