Instrumenting LG webOS apps¶
- LG webOS
To prepare an LG webOS app you have three choices. Either use our Lite solution (see below) or have the Instrumentation library automatically injected into the package or manually insert the instrumentation code into every HTML file of your app. Then create a build and upload it to Suitest.
Only
.ipk
package file extension is supported.
At this point you should have a working LG webOS device in your Suitest account.
WatchMe demo application
If you are looking for an LG webOS 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 either use our Lite solution or setup the Suitestify.
If using Automated library injection:
- 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.
Choosing Lite or Instrumentation library¶
Suitest is using 2 different solutions to access information from a LG webOS application:
- Lite (recommended)
- No code needs to be injected into your application.
- Instrumentation library
- Injecting a JavaScript code into your application.
Here you can see the differences between these solutions:
Feature support | Lite | Lite (with Suitestify) | Instrumentation library | Instrumentation library (with Suitestify) |
---|---|---|---|---|
Identifying element based on link text | - | - | ✓ | ✓ |
Testing pseudo elements | ✓ | ✓ | - | - |
Testing more shadow DOM elements | ✓ | ✓ | - | - |
Network requests | ✓ | ✓ | - | ✓ |
- for audio/video files | - | ✓ | - | ✓ |
- to local files | ✓ | ✓ | - | - |
- to IP addresses | ✓ | ✓ | - | - |
3rd party cookies | ✓ | ✓ | - | - |
Using Lite¶
Select Lite - no Instrumentation library (recommended) option inside the Instrumentation library section of your application configuration.
No further action related to the instrumentation library needed. You can continue with package upload.
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 LG webOS app is hosted (package referencing a URL), then you will need to enable Suitestify.
If the process fails, please follow the manual instrumentation guide.
Insert the library 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 Suitest instrumentation library, ensure you do not accidentally release the app to production with the Suitest code included. Suitest code is intended for testing and could impact the user experience of your application.
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.
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.