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.
Only
.wgtand.tmgpackage file extensions are supported. For more information see the Uploading package to Suitest section below.
At this point you should have a working Samsung Tizen device in your Suitest account.
WatchMe demo application
If you are looking for a Samsung Tizen application to try Suitest with, feel free to use our WatchMe demo application. Please note that this app is a hosted one. Therefore, you will need to setup the Suitestify.
- On the application settings page you will need to enable Suitestify by checking the Enable Suitestify checkbox.
- Into the list of domains, please insert the following ones: watchme.suite.st, file.suite.st.
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.
Content Security Policy¶
Samsung Tizen supports CSP web standard. Suitest loads instrumentation library from https://*.suite.st domain.
Make sure to configure your CSP to allow loading scripts and data from that domain.
Examples:
Basic:
default-src 'self' 'unsafe-eval' 'unsafe-inline' blob: https://*.suite.st wss://*.suite.st; object-src 'none'
For advanced users:
img-src https://*.suite.st; script-src https://*.suite.st 'unsafe-eval' 'unsafe-inline' blob:; connect-src https://*.suite.st wss://*.suite.st; style-src 'unsafe-inline'; frame-src https://*.suite.st
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.
Uploading a .tmg package
Together with a .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.