CONEMO Android App

This application serves as the patient-facing Cordova portion of the NIH funded CONEMO project.

Build dependencies

• NodeJS
• NPM (NodeJS Package Manager)

Installation process

Download and install NodeJS and the Node Package Manager

Install the application dependencies

npm install

node_modules/.bin/bower install

Adding the Android platform

rm -rf platforms
mkdir www
LOCALE=es-PE API_SERVER=http://localhost:3000 \
LESSON_SERVER=http://localhost:3000 \
node_modules/.bin/cordova platform add android

Adding the background mode plugin

LOCALE=pt-BR API_SERVER=http://localhost:3000 \
LESSON_SERVER=https://conemo.northwestern.edu \
node_modules/.bin/cordova plugin add https://github.com/katzer/cordova-plugin-background-mode.git#0.6.4

Adding the start on boot plugin

LOCALE=pt-BR API_SERVER=http://localhost:3000 \
LESSON_SERVER=https://conemo.northwestern.edu \
node_modules/.bin/cordova plugin add https://github.com/tsubik/cordova-plugin-start-on-boot.git

Running tests

npm test

Building and installing the app on an Android device or emulator

LOCALE=es-PE API_SERVER=http://localhost:3000 \
LESSON_SERVER=http://lessons.example.com \
npm run install:android

Running in the browser

The first time

LOCALE=es-PE API_SERVER=http://localhost:3000 \
LESSON_SERVER=http://lessons.example.com \
node_modules/.bin/cordova platform add browser

Then build

LOCALE=es-PE API_SERVER=http://localhost:3000 \
LESSON_SERVER=http://lessons.example.com \
node_modules/.bin/cordova build browser

And finally install (which is all you will need to run on subsequent installs)

LOCALE=es-PE API_SERVER=http://localhost:3000 \
LESSON_SERVER=http://lessons.example.com \
npm run install:browser

While running the app in the browser you may want to clear the database. To do this run indexedDB.deleteDatabase('conemo'); localStorage.clear() in the browser console.

Building a production release

This assumes you have a build configuration file at ~/.ssh/android-build.json

LOCALE=es-PE API_SERVER=http://example.com \
LESSON_SERVER=http://example.com HOCKEY_APP_ID=12345 \
node_modules/.bin/cordova build android \
--buildConfig ~/.ssh/android-build.json --release

Running in an emulator

Make sure you have an SD card enabled so that the video downloads work.

If your computer is on WiFi, disable your LAN (it may be called "Thunderbolt Bridge"). Restart your virtual device and confirm that it has access to the internet.

Testing locally with mock node server

If you'd like to run the app locally without needing to run the dashboard and set up a participant, build the app with the mock node server, SERVER=http://127.0.01:1337, as the endpoint. For example:

LOCALE=es-PE API_SERVER=http://localhost:3000 \
LESSON_SERVER=http://lessons.example.com \
npm run install:android

You will also need to run the mock server.

node path/to/conemo_app/test/support/dummy_server.js

Now, with a phone tethered to your computer and port forwarding enabled, you can enter whatever you'd like as the configuration token.