Sandbox Helper


When building sandboxed apps, it can be tedious to determine all of the files that the app requires. The sbhelper host tool dynamically traces an app to determine the files it's trying to access, and then prompts for permission for the app to use the missing files traced.

To use sbhelper:

  • Create your app as usual filling in all the Application Definition .adef sections. Complete as much of the requires file section as possible.
  • Run sbhelper specifying the target device app name, target type, and the IP address (DEST_IP). If DEST_IP isn't specified on the command line, the contents of the DEST_IP environment variable will be used.

sbhelper will:

  • Build the app.
  • Install it on the target.
  • Trace the app on the target to determine any missing required files.
  • Append the set of required files to the the app's adef file.
  • Rebuild the app and reinstall on the target.

sbhelper currently has some limitations:

  • it can't guarantee that all code paths are traced and so there may be required files that aren't caught.
  • it can't determine if the app is functioning as the developer intended so you must check the resulting app is working properly.
  • automatically determining resource limits isn't supported yet.