Before you start¶
Before going ahead with test automation you need to make a small one-time adjustment to your app. At this point you should already have a configured device in your account.
Here are a few terms that we use a lot at Suitest:
-
Suitest app - a project in Suitest that contains configuration and test scenarios for the app you want to test.
-
Suitest app version - a version of Suitest app with unique set of test scenarios and configurations. It is expected that versions inside a single Suitest app are not much different, but unequal in order to correspond to differences between the tested application versions.
-
instrumentation library - a library provided by Suitest that works like a testing agent from inside of your app. The process of including the library into the app is called instrumenting and after that the app is referred to as instrumented app.
-
Lite - a way of gathering the data from tested applications without involvement of instrumentation library.
-
app ID - this identifies your Suitest project. You may need this ID when instrumenting your app.
-
app platform - software platform on which your app will run. For example Android TV, HbbTV, Samsung Tizen, etc.
-
app configuration - settings that define the environment in which your app will run when testing. Also contains a ID which is used for Suitest JavaScript API.
Now that you are familiar with the terminology, here is what you need to do to start testing:
-
Prepare the application (if needed):
- Android (automatic injection of Native apps)
- Apple iPhone/iPad (iOS/iPadOS)
- Apple TV (tvOS)
- HbbTV / Freeview Play (automatic injection)
- HTML-based
- LG webOS (automatic injection OR Lite)
- NextGen TV / ATSC 3.0 (automatic injection)
- PlayStation 4/5
- Roku (automatic injection OR Lite)
- Samsung Tizen (automatic injection OR Lite)
- Sky (automatic injection OR Lite)
- VIDAA (Lite)
- Vizio SmartCast (automatic injection)
- Websites (automatic injection)
- Xbox (One, Series X/S) (automatic injection of HTML-based local apps)
- Xfinity / Xumo TV / XClass TV (automatic injection OR Lite)
If you intend to use only our image-based testing features (assert image and OCR) combined with device control, the application does not need to be instrumented even if Lite is not available.
-
Upload app package or specify the URL of the application in the configuration.
-
Create and run a one-line test to check that the configuration works as expected.