| commit | 6272f51e3ec246d97da1d91cbb286beb17f05186 | [log] [tgz] |
|---|---|---|
| author | Gord Tanner <gtanner@gmail.com> | Tue Mar 12 09:39:30 2013 -0400 |
| committer | Gord Tanner <gtanner@gmail.com> | Tue Mar 12 09:39:30 2013 -0400 |
| tree | d95c0d6ae1b29fa77d93d4195f618dc62a6f9c82 | |
| parent | 5c3a65055c58c84b52b7084936fbaca6af3c50da [diff] |
Update package.json. This is to prep for getting this into npm for the hosted / cli version of ripple.
A browser based, platform agnostic mobile application development and testing tool.
All source code (excluding third party libraries) are subject to:
Copyright (c) 2011 Research In Motion Limited
All assets in this repository, unless otherwise stated through sub-directory LICENSE or NOTICE files, are subject to the Apache Software License v.2.0.
In particular, the assets under assets/*/images are excluded from the Apache Software License v.2.0. Please see the NOTICE file for more details.
If you plan to dive into the source, be sure to check out the HACKING file.
To get started, you need to setup a few things, first- run (in the project root):
./configure
This script will pull down the needed npm packages and initialize the submodules.
jake
This will build ripple to the pkg/ folder. In that folder there are various targets that can be used.
jake -T
This will describe all the available commands for building and running the tests, etc.
pkg/chrome.extension folder.NOTE: For development you should be fine to just build with jake and refresh your browser. If you end up editing anything in the ext folder you will need to refresh the extension from the extension management page.
For more information see doc/chrome_extension.md.
Ripple is (by-design) browser agnostic, and should be able to run inside any web browser.
If you want to run it inside other browsers, you will need to use the pkg/hosted target, paired with the CLI's emulate command.
Ex (using the NPM package):
ripple emulate --path to/my/app # or ripple emulate --remote http://remote-site.com
Then navigating to (your app's html file):
http://localhost:PORT/index.html?enableripple=true
There is a command line interface that can be paired with the client (UI).
It can be used for various things, such as statically hosting an application, and running a local (cross origin) XHR proxy.
Eventually, this will be available on the NPM registry. For now (to install):
git clone git@github.com:blackberry/Ripple-UI.git ripple cd ripple ./configure jake npm install -g .
This will install a global script called ripple. To see usage, run:
ripple help
Note: If you don't want to use NPM, you can just do this:
node bin/ripple help
The master branch is the latest (stable) release. The next branch is where all development happens.
If you like the project, and want to contribute code, please issue a pull request (on GitHub) into the next branch.
Note: You will need to be an official contributor before your code can be accepted.
jake lint, no new lint errors introduced.You can also find associated reference material for the Ripple tool as well as contributor forums at the following locations.