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.
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.
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://the.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¶
- On the application settings page you will need to enable Suitestify by checking the Enable Suitestify checkbox.
- 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.