How to run this project

February 1, 2018 · View on GitHub

This project has been designed to be integrated inside and AOSP tree. It has been tested on the HiKey 620 board (arm64) and on the x86_64 emulator. It should work with minimal modifications on the ia32 emulator on other arm boards supporting Android.

Before following those steps, you need to use the https://github.com/fdgonthier/Aosp-Node-Prebuilts project so that a Node.js binary is present on your target. Remote Interface requires Node.js and will not work without it.

You first also need a working version of Node.js. https://nodejs.org/en/download/package-manager/

Install the required packages:

$ npm install

Assemble the package to install on the device:

$ grunt [x86_64|arm64]

Run 'mm' to insert the application on the device

$ mm

Running

The application can be run from the ADB shell but you need to forward ports first:

$ adb forward tcp:3000 tcp:3000

You can then run the application from within the ADB shell:

$ OsysPE

You can access the app on localhost:3000

The application will output plenty of debugging statements when running.

Cleaning / Reinstalling

To remove the application from the build:

Remove the launcher

$ rm out/target/product/[product name]/system/bin/OsysPE

At this point, if you run mm again, the application will be reinstalled on the device. This is how to reinstall the app if you've done modifications.

$ rm -rf out/target/product/[product name]/system/Osys/PE

Licensing

See the NOTICE file.

Contributors