Instrumenting Samsung Tizen apps

To instrument a Samsung Tizen app you have two choices. Either have the library automatically injected into the package or manually insert the Suitest instrumentation code into every HTML file of your app. Then create a build and upload it to Suitest.

At this point you should have a working Samsung Tizen device in your Suitest account.


Inject the library automatically

Suitest can automatically inject the instrumentation library into your application package without your interaction. Select Inject the library automatically before uploading the app package under the App details tab.

Inject the library automatically

If your Samsung Tizen app is hosted (package referencing a URL), then you will need to enable Suitestify.

Instrumentation limitations

Suitest can only auto-instrument .wgt packages (not .tmg). Upon instrumentation, the package will be re-signed with our own certificate. In case your application requires some specific permissions that are not available for standard public or partner certificate, you would have to instrument the application manually.

If the process fails, please follow the manual instrumentation guide.

Inserting instrumentation code manually

Copy and paste the code snippet from the Suitest configuration page into every HTML file of your application. For best results put it as the first script element in your HTML file right after the opening <head> tag.

Inserting Suitest instrumentation library for HTML apps

Instrumentation library in production

When inserting the instrumentation library you must make sure, that you don't accidentally release the app to production with Suitest code in it. Suitest code is intended for testing and could damage the user experience of your app's users.

Mind Content Security Policy

Samsung Tizen supports CSP web standard. Suitest loads instrumentation library from https://*.suite.st domain. If you choose to use Suitestify proxy, some requests will also go through https://*.suitest.net domains. Make sure to configure your CSP to allow loading scripts and data from those domains. Read more about CSP on Tizen.

Uploading package to Suitest

You can upload the package on the configuration page. Suitest will automatically install or update the package on the device as necessary when you try running the app on this device.

If you use Suitest Network API you can also send the package with an API request. Suitest will automatically install or update the package on the device as necessary when you try running the app on this device.

Supported package type

Suitest can work with both .wgt and .tmg package type. You can upload a .wgt package directly on the configuration page. For .tmg package Suitest also needs a license in order to be able to install it on the device automatically. Archive a .tmg package and widget.license file together and upload the resulting .zip into Suitest app configuration page.

Setting up Suitestify

Enable Suitestify

  1. On the application settings page you will need to enable Suitestify by checking the Enable Suitestify checkbox.
  2. Make sure application domain name is listed in the Suitestify settings. For example, lets assume that the app is hosted at https://example.com therefore the domain added to the domain list is example.com.
Suitestify with .tmg package

There are extra steps needed for using Suitestify with .tmg package.