Skip to content

Latest commit

 

History

History
26 lines (20 loc) · 1.75 KB

run_app.md

File metadata and controls

26 lines (20 loc) · 1.75 KB
Raw

Running Apps

This document covers how developers can run applications on a devkit/console.

Starting with 0.9.3.3995, App Runner in no longer needed to pack apps before installation. Instead, the Microsoft Sync Framework (see dev environment pre-requisites) is used to sync builds to a target machine. This avoids unnecessary work like:

  • Creating large compressed archives
  • Re-transferring an entire build when many files are unchanged

The Microsoft Sync Framework must be installed on devkits and anywhere you use devtools. It is pre-installed in the latest OS image (v1.09 or later) for both console and PC mode.

How to run the app

There are the basic steps for testing your app on the console.

  1. Integrate Ruyi SDK into your app
  2. Create a RuyiManifest.json at the root of a build
  3. If using console mode (i.e. not in PC mode), you must enable developer mode in Settings and sign the app
  4. Open Dev Tools
  5. Choose App Runner, fill the proper IP address and choose your manifest file
  6. Click Install App
  7. Wait for it to finish

Done and have fun!!

IF error happens, make sure the Microsoft Sync Framework has been installed on your PC and the target console has been updated to the latest version of the OS.

Limitations

  • You may be asked for admin priviledges the first time you install an app with devtool (we need to open a specific port for sync). Click Yes.
  • The sync is done over TCP protocol. Currently it only supports machines located in the same LAN as where devtool is running.