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:

  1. Create a Suitest app

  2. Create an app configuration

  3. Prepare the application (if needed):

    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.

  4. Upload app package or specify the URL of the application in the configuration.

  5. Create and run a one-line test to check that the configuration works as expected.