Developing Adapt It Mobile on OS X

Basic steps to getting started with Adapt It Mobile development on OS X. Note that Android will be developed on Linux, just to keep things simpler...

1. Download and install node.js from: http://nodejs.org.

2. Open a Terminal window and type in the following commands:

   sudo npm install -gf cordova i18next i18next-conv

   sudo npm update -g

3. Download and install GitHub for Mac from: https://github.com.

4. While on the https://github.com web page, sign up for an account on GitHub and log in.

5. Go to the github page for adapt-it-mobile: https://github.com/adapt-it/adapt-it-mobile. On that page, click on the Fork button.

6. On the github web page for adapt-it-mobile, click on the Clone in Desktop button. Your browser should ask if you want to launch the GitHub app. Let it do so. Follow the prompts in the GitHub app to select a directory to store the copy of adapt-it-mobile.

7. [Optional] Install the iOS simulator, if you want to launch the simulator from the command line (Note: you can also run the iOS simulator from Xcode, so this is an optional step). From the command line, type in the following: npm install -g ios-sim.

8. [Optional] Download and install Inkscape from http://inkscape.org/

9. [Optional] Schedule a launchd job to regularly update the npm packages (cordova, i18next and i18next-conv).

   a. In the Terminal window, cd into the the adapt-it-mobile folder you cloned from GitHub.

   b. Type the following into the Terminal window:

   cp npm_update_daily.plist ~/Library/LaunchAgents/npm_update_daily.plist

   c. The npm_update_daily.plist file you just copied over is a launch agent definition that will kick off at 10:!5AM every morning and call “npm update”. This definition will be picked up the next time you restart your computer.