commit | f8c6a0bc99619badbb2270a43ed481342dcc1047 | [log] [tgz] |
---|---|---|
author | Tim Barham <tim.barham@microsoft.com> | Mon Aug 17 14:25:45 2015 +1000 |
committer | Tim Barham <tim.barham@microsoft.com> | Mon Aug 17 14:25:45 2015 +1000 |
tree | 8fce7602ea757aae9c5129bdca82c516b08f0518 | |
parent | e0a0fb8b520d5cbb0371efa0d995dd1ba261f2bc [diff] |
v0.9.32
A browser based, platform agnostic mobile application development and testing tool.
Common
nodejs
(v0.12.0
or higher)npm
(v2.5.1
or higher)python
(v2.7.3
recommended, v3.x.x
is not supported)OSX / Linux
make
Windows
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.
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.
To install:
npm install -g ripple-emulator
This will install a global script called ripple
. To see usage, run:
ripple help
If you like the project, and want to contribute code, please issue a pull request (on GitHub) into the master
branch.
Note: You will need to submit an Apache ICLA (Individual Contributor License Agreement) for your contribution to be accepted.
jake lint
, no new lint errors introduced.