Skip to content

opersys/file-explorer-web

Repository files navigation

How to run this project

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 or no 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.

If you do not want to setup a Node.js environment, you can download the prebuilt package for the most current version. This package is larger but include all the dependencies required for File Explorer to work. The package is available in the Releases section of the GitHub repository. If you use that package, skip the following steps to up until running "mm".

If you do not want or can't use the prebuilt package, you need to setup a working Node.js environment. See https://nodejs.org/en/download/package-manager/ to install it on your computer

If you want to build from source, checkout the project in the :

$ 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:

$ OsysFE

You can access the app on localhost:3000

The application will output plenty of debugging statements when running.

Cleaning

To remove the application from the build:

Remove the launcher

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

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/FE

Contributors