Setting up your development environment for Moodle Mobile 2 (Ionic 1): Difference between revisions
Juan Leyva (talk | contribs) |
(Minor error) |
||
Line 20: | Line 20: | ||
'''Install ionic:''' | '''Install ionic:''' | ||
npm cache clean | npm cache clean | ||
npm install | npm install -g cordova ionic | ||
'''Clone the code base into a local directory in your computer.''' | '''Clone the code base into a local directory in your computer.''' |
Revision as of 16:16, 8 March 2016
Note: This page is a work-in-progress. Feedback and suggested improvements are welcome. Please join the discussion on moodle.org or use the page comments.
Overview
The majority of your development work will be do using the browser. You will likely begin to use an emulator once you need to simulate a real mobile device.
Requirements
Install a browser for development
I recommend Chromium browser (Google Chrome open source version) https://download-chromium.appspot.com/ Please, read Moodle_Mobile_development_using_Chrome_or_Chromium for more information
Install Node.js
http://nodejs.org for Mac users I recommend to install nodejs via macports.
IMPORTANT: Don't use node 4.0 or higher, there are incompatibilities with some of the packages we use. Please use v0.12.7 instead.
Install ionic:
npm cache clean npm install -g cordova ionic
Clone the code base into a local directory in your computer.
git clone https://github.com/moodlehq/moodlemobile2.git moodlemobiledirectory cd moodlemobiledirectory
Install the npm plugins dependencies
npm install (This will install all the dependencies listed in package.json) npm install -g bower (This will install bower in a folder that should be in the PATH) npm install -g gulp (This will install gulp in a folder that should be in the PATH)
Add the iOS and Android platforms
ionic platform add ios ionic platform add android
Install the required Cordova plugins
Run the following command for install all the required Cordova plugins
ionic state restore
Please, note that if you are creating a custom app with a custom URL scheme, you should edit the /package.json file and specify there your custom URL_SCHEME (replacing the existing value)
Install bower globally and the required javascript files
bower install (this will install all the libraries listed in bower.json)
Run gulp’s default tasks (in order to create the build files)
gulp
Open the app in the browser
First start chromium via the command line using the custom parameters as is mentioned here: Moodle Mobile development using Chrome or Chromium
and then, start the Ionic server:
ionic serve --browser chromium
Editor
There are several plugins for AngularJS and Ionic development available for common editors.
Sublime 3 has plugins for jscs (coding style) and jshint (linter)
Configuration files for jscs and jshint can be downloaded from https://github.com/angular/angular.js (.jscs.json and .jshint*)
Updating ionic and cordova
sudo npm update -g cordova sudo npm update -g ioni
ionic platform update android ionic platform update ios
Updating plugins
cordova plugin rm your_plugin_id cordova plugin add your_plugin_id
See also
http://cordova.apache.org/docs/en/5.0.0/guide_platforms_index.md.html#Platform%20Guides How to install different platforms SDK and emulators