A module that provides:
- command line to generate, package, install, run and debug Open webOS applications.
- an Ares plugin generate, package, install, run and debug Open webOS applications from Ares IDE.
-
In order to hack on
ares-webos-sdk
:$ git clone --recursive https://github.com/enyojs/ares-webos-sdk $ cd ares-webos-sdk $ npm install
-
In order to use a development tree of
ares-webos-sdk
from within your own project (eg. from the Ares IDE), manually add this modules under the source-code Ares using NPM:$ cd /path/to/ares-webos-sdk $ npm install $ cd /path/to/ares-ide $ npm install ../relative/path/to/ares-webos-sdk
-
In order to use a specific version of
ares-webos-sdk
in your own modules (eg. from the Ares IDE), without actually working on it, then runnpm install git@github.com:enyojs/ares-webos-sdk#0.0.1
where0.0.1
is the version you want to use (not yet working). -
On Mac OS X, you need to install Xcode and Xcode Command Line Tools (Xcode -> Preferences -> Downloads -> Components)
Please refer to SSH-KEY-SETUP.md for intructions.
In case your webOS SDK (and/or Ares IDE) are both running in VirtualBox guests, you need to tunnel the port 5522 from the IDE guest to the emulator guest (replace <username>
)
$ ssh -L5522:localhost:5522 <username>@10.0.2.2
The commands ares-* can be invoked from anywhere in the file system provided the PATH has been set correctly.
On Linux and Mac OS X:
$ export PATH=$PATH:<webos-sdk-commands-full-path>/bin
For example: export PATH=$PATH:/Users/ares/GIT/ares-webos-sdk/bin
On windows (cmd.exe):
> SET PATH=%PATH%;<webos-sdk-commands-full-path>/bin
For example: > SET PATH=%PATH%;C:\Users\ares\GIT\ares-webos-sdk/bin
NOTE: On Windows, you can also use a bash enviromment. For example: Git for Windows which provides a bash shell as on Linux.
Warning: http proxy is not yet supported.
$ ares-generate -l
$ ares-generate -t bootplate-2.1.1-owo -p id=com.myapp -p version=1.2.3 -p title=MyApp MyApp
$ ares-package MyApp
NB: ares-package will minify the application if possible.
ares-package will also copy appinfo.json and framework_config.json after the minification
$ ares-install --list
$ ares-install --install com.myapp_1.0.0_all.ipk
$ ares-install --remove com.myapp
--install
is the default:
$ ares-install com.myapp_1.0.0_all.ipk
$ ares-launch com.myapp
There are two diferent project template configuration.
- for the command line ares-generate
- for the Ares IDE
The project templates used by the command line ares-generate
are defined in the file templates/project-templates.json
.
Additional templates could:
- be added directly into the file 'templates/project-templates.json'
- be added thru command line option '--repo '
- be added directly in the code of ares-generate. For that, go in 'lib/ares-generate.js' in the property 'this.repositories'. The entries of 'this.repositories' can either be local files under the 'templates' directory or files accessible thru http.
This module "ares-webos-sdk" brings some additional project templates for webOS
and override some project template definition brought by the Ares IDE.
This is done by the "genZip" entry of the file "ide.json" stored in the main directory of this module.
See Project template configuration in ares-project for more information.
The source code of this module is organized as follow:
ares/client
: This is a browser side code of the webOS Ares plugin loaded in the Ares IDE. This part is written in enyo.ares/server
: This is a server side code of the webOS Ares plugin loaded in the Ares IDE. This part is in javascript running into a nodejs server.bin
: This directory contains the .sh and .bat wrappers for the ares-* commandslib
: This directory contains the javascript code used by the server side Ares plugin and the ares-* commands.scripts
: This directory contains script(s) used during 'npm install' to 'npm install' node modules integrated as git submodules.templates
: This directory contains project template definitionstest
: This directory contains various tests for that module.
-
Start the emulator
-
Run the
novacom
interface tester$ test/novacom.spec.js novacom #put ✓ should write a file on the device (1049ms) ◦ should fail to write a file in a non-existing device folder: sh: can't create /dev/null/mocha72996: nonexistent directory ✓ should fail to write a file in a non-existing device folder #get ✓ should write then read the same file from the device (1021ms) #run ✓ should fail to run a non-existing command ◦ should write a file on the device and 'ls' it successfully: ✓ should write a file on the device and 'ls' it successfully (1054ms) ✓ should fail to 'ls' a non-existing file (43ms) 6 tests complete (11 seconds)
-
Run the
luna
interface tester$ test/luna.spec.js luna #send ✓ should fail to invoke non-existing service ✓ should list luna statistics (51ms) 2 tests complete (132 ms) $ test/novacom.spec.js
-
Run the
sdk
interface tester (Note: you need a specific package in you home directory).$ test/sdk.spec.js installer #install ✓ should install a package (2808ms) #list ✓ should list installed packages (141ms) 2 tests complete (3 seconds)
Whether there are one or several Emulator images, TCP Ports Redirections remain the same:
| Name | Host Port | Guest Port | Role | | palm.emulator.debugger | 5858 | 5858 | TBC | | palm.emulator.hostmode | 5880 | 8080 | TBC | | palm.emulator.inspector | 9991 | 9991 | TBC | | palm.emulator.ls2.private | 5512 | 4412 | TBC | | palm.emulator.ls2.public | 5511 | 4411 | TBC | | palm.emulator.ssh | 5522 | 22 | TBC |