Instrumenting Roku apps

Instrumenting Roku app takes only a few easy steps. At this point you should have configured Roku in your Suitest account.


  1. Add a status change observer to initialize our library and to setup an appID.

    sub OnSuitestLibStatusChanged(event as object)
      if event.getData() = "ready"
       SuitestIL = CreateObject("roSGNode", "SuitestInstrumentationLib:main")
       SuitestIL.SetField("app_id", "75fc10d1-bf06-4046-8e09-b044bbf93726")
      end if
    end sub
    
  2. Create an ComponentLibrary with the instrumentation library URL in the uri field.

    sub init()
      SuitestLib = CreateObject("roSGNode", "ComponentLibrary")
      SuitestLib.ObserveField("loadStatus", "OnSuitestLibStatusChanged")
      SuitestLib.SetField("uri", "http://the.suite.st/app/roku.zip")
      m.top.InsertChild(SuitestLib, 0)
    
    ' ...app init code
    
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.

Uploading package to Suitest

After you have instrumented the code create a development build of your app and upload it at the Suitest 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.