Containes RAPPCloud API modules used for interfering wth RAPP Platform as well as the RAPP Objects.

To use this JS API you need nodejs and npm. You can run the global_deps_install_script.sh located in the root folder to install them along with grunt-cli and mocha which are the global dependencies the API needs for task management and testing.

The rest dependencies (required npm modules), will be taken care of, from npm while you install the rapp-platform-api package.

Installing the rapp-platform-api is as easy as

npm install rapp-platform-api

To install it globally:

npm install rapp-platform-api -g

If you also want to install the developer depencdencies, go to the root folder of the project and execute:

npm install

The examples located in the examples directory showcase how you may use the RAPPCloud services for your convenience. Provided you have succesfully installed the API in your system, you can require the service(s) that you want to use in your application, after requiring the RAPPCloud module as shown in the examples:

var RAPPCloud = require('rapp-platform-api/includes/cloud/RAPPCloud');
RAPPCloud.qrDetector = require('rapp-platform-api/includes/cloud/qrDetector');

For the RAPP platform API objects you would have to point as well, to the respective directory in order to require them:

var RAPPObjects = require('rapp-platform-api/includes/cloud/RAPPObject');
RAPPObject.face = require('rapp-platform-api/includes/objects/face');

On default the RAPP API connects on a RAPP Platform installed LOCALLY. TODO: Provide the configuration parameters to connect the API to:

• The RAPP Platform Deployment Server.
• The RAPP Platform Development Server.

• includes/cloud: The RappCloud services directory.
• includes/objects: The Rapp Objects directory.
• examples: Examples that showcase how you may use the RAPPCloud services for your convenience.
• test: Unit tests for all the services and objects.

For the following to run you will also need to install the developer dependencies (check installation section).

In the test directory unit tests for all the services and objects can be found. In order to run them while on root directory type:

npm test

For the following to run you will also need to install the developer dependencies (check installation section).

This package's source-code is documented using the JSDoc javascript documentation generator.

Generate documentation for the RAPP API Cloud Services only:

npm run doc-cloud

Generate documentation for the RAPP API Objects only:

npm run doc-objects

Gererate documentation for ALL:

npm run doc

Or

grunt jsdoc

Generated doc files are located under the doc/ directory.

• Lazaros Penteridis, [[email protected]]