mwiemarc / node-android

Run Node.js on Android by rewrite Node.js in Java

node-android

Run Node.js on Android by rewrite Node.js in Java with the compatible API.

third-party: libuvpp, libuv-java JNI code by Oracle.

Build

Clone the code, open Android Studio (1.*) and import the project.

For Eclipse ADT user, refer to https://github.com/InstantWebP2P/node-android/tree/adt

Javascript code injection

> adb shell am start -a android.intent.action.VIEW -n com.iwebpp.nodeandroid/.MainActivity -e js "var run = function () { return 'hello world'; } run();"

Features

• Node.js 0.10.x compatible API
• Multi-threading: run separate node context in Java thread
• libUV native support
• Timer, set/clear Timeout/Interval
• EventEmitter
• Stream
• HttpParser(rewrite http-parser.c in java)
• HTTP
• HTTPP(run http over udp)
• TCP
• UDT(udp transport)
• DNS
• URL
• IPv6
• for API usage, check https://github.com/InstantWebP2P/node-android/tree/master/app/src/main/java/com/iwebpp/node/tests
• WebSocket/WebSocketServer supported, check https://github.com/InstantWebP2P/node-android/tree/master/app/src/main/java/com/iwebpp/wspp/tests
• Connect middleware
• Crypto: NACL support, public box,secret box,signature/verify
• SecureWebSocket over NACL

JS runtime

• Rhino supported
• Exposed node-android packages: com.iwebpp.node.http, com.iwebpp.node.stream, com.iwebpp.node.net, etc
• Exposed node-android classes: com.iwebpp.node.EventEmitter2, com.iwebpp.node.Dns, com.iwebpp.node.Url, etc
• Exposed node-android native context in JS standard scope as NodeCurrentContext alias NCC
• Exposed Android API: android.util.Log
• NodeJS compatible internal modules are available in JS standard scope
• Exposed WebSocket classes: com.iwebpp.wspp.WebSocket, com.iwebpp.wspp.WebSocketServer

JS usage

• In case Rhino, create class 'MyScript' extends from com.iwebpp.node.js.rhino.Host
• Implement 'public String content()' in 'MyScript' to return user script
• Execute JS engine in a separate Java Thread with 'MyScript.execute()'
• When authoring script, please use NodeCurrentContext(alias NCC) in node-android API
• For details, check https://github.com/InstantWebP2P/node-android/tree/master/app/src/main/java/com/iwebpp/node/js/tests

TODO

• API doc, more demos
• JS runtime CommonJS/AMD compliance

### License

(see LICENSE file)

Copyright (c) 2014-2016 Tom Zhou([e-mail])