FC-Connect

Mobile Vaccination Forecasting and Tracking

FC-Connect is a hybrid mobile app, it is written using modern web technologies like HTML5, CSS, and Javascript.

Toolchain

Our tool set pulls from the nodejs environment.

Unit tests

• Testing Suite

  • Test runner - Karma
  • Test framework - Jasmine

  http://karma-runner.github.io/0.13/index.html http://jasmine.github.io/

• Running tests

  karma start

• Viewing Unit Test Coverage report

  • The coverage report will be generated after you start karma and will be located in /coverage/Chrome*/index.html

Quick(ish) Start

• Install nodejs from nodejs.org. Windows users will download and run the installer while Linux users will add the ppa and then use apt-get to install the package.

  sudo apt-get install -y nodejs

• Download and install the Android SDK.
  • Installing Android studio will ensure you have everything you need and provide a good tool for setting up AVD's if you choose to attempt to emulate android (not recommended due to poor performance, use a physical android device if possible)
• Use npm to install the tools globally.

  npm install -g bower gulp mocha ionic cordova

• Run the following commands in a shell to setup for the build.
  • If running OSX you may run into trouble with the android commands due to environment variables, this should help: http://stackoverflow.com/questions/19986214/setting-android-home-enviromental-variable-on-mac-os-x

    npm install
    bower install
    gulp
    ionic platform add android
    ionic platform add ios
    ionic resources android
    ionic resources ios

• Build the app!

  ionic build android
  ionic build ios

• Emulate

  ionic emulate android (ionic run android if using genymotion)
  ionic emulate ios