API.txt

# DrupalGap API

  http://api.drupalgap.org

## The DrupalGap API is generated using:

  https://github.com/jsdoc3/jsdoc

## We use a forked copy of the JSDOC repo:

  https://github.com/signalpoint/jsdoc

## This command can be used to re-generate the API:

  cd ~/Desktop/github-code/jsdoc
  ./jsdoc ~/Desktop/github-code/DrupalGap/src/drupalgap.js ~/Desktop/github-code/DrupalGap/src/includes/*.js ~/Desktop/github-code/DrupalGap/src/modules/*/*.js ~/Desktop/github-code/DrupalGap/jDrupal/src/*.js ~/Desktop/github-code/DrupalGap/jDrupal/src/*/*.js

After re-generating the API, delete all the files from www/api on the server,
then upload the contents of the 'out' directory to the server.

# drupalgap.min.js

When generating the drupalgap.min.js file, the web service based closure
compiler has a file size limit that we are exceeding. Therefore we install
the closure compiler app locally:

https://developers.google.com/closure/compiler/faq#size-restrictions
https://developers.google.com/closure/compiler/docs/gettingstarted_app

This app requires JDK7, and you can use the following terminal command to switch
between java versions:

sudo update-alternatives --config java

FYI, we were running JDK6 in Ubuntu prior to this, so when using Eclipse for
Android, we may have to switch back to 6 from 7.

The following command can be used to make the minifed JS file:

java -jar compiler.jar --js /var/www/drupal-7/mobile-application/bin/drupalgap.js --js_output_file /var/www/drupal-7/mobile-application/bin/drupalgap.min.js