IHC EMR Project

---

Clients

The client section assumes that the user will be running the server on a Raspberry Pi Model 3+ and the application on an Android tablet. An APK file will be posted in GitHub releases with the server IP address already having been pre-configured during the build process.

Server Setup

To start, you will need to be running a 32-bit Raspbian OS on a Raspberry Pi Model 3+. If you do not have Raspbian, please using the official imager to flash a fresh version on to your RPI's SD card. Note that the server runs fine on any version of Linux, but this guide was written assuming you are using the above specfications. Additionally, please make sure that your username on the RPI is pi.

Once that is done, please open up the "Terminal" application and type in the following command. After you have typed this phrase, you need to press [ENTER] at the end.

curl -sL https://raw.githubusercontent.com/TritonSE/ihc-emr/master/scripts/setup.sh | bash -s

You should see output being displayed. If any of the output indicates an error has occurred, please contact us for further help. Otherwise, at this point, the server will be running indefinitely on the Raspberry Pi.

Android App Setup

Please visit the releases section and download the latest version of the APK to your tablet. Everything should work out of the box.

---

Developers

The developers section assumes that the user will be running the app on an Android tablet emulator and hosting the server on a local MongoDB instance. You must also be using NodeJS v10 or lower due to issues with Realm.

Local Environment Setup

1. Make sure you have NodeJS v10 and jdk 1.8 (JAVA 8) installed. Run npm install -g react-native-cli in your terminal.
2. In terminal, go to your preferred directory for the project to be located at and run git clone https://github.com/TritonSE/ihc-emr.
3. In the directories mobile and server, run npm install.
4. Install MongoDB.
5. (Recommended) Open the project through Android Studio.
6. Set environment variable ANDROID_HOME to the location of Android SDK on computer. Set environment variable JAVA_HOME to the location of jdk 1.8(JAVA 8) on computer.

Running the Application

1. In Android Studio, press the AVD Manager button on the top right. Create a new virtual device, a 10 inch tablet and run the emulator.
2. Make sure MongoDB is running. Link to Instructions
3. In directory server, run npm start to run the server.
4. In directory mobile, run react-native run-android to start the application on the emulator.

Building an APK

1. If you don't have a signing key yet, generate a signing key. In mobile/android/app run this command and follow the steps to generate the key:

   keytool -genkey -v -keystore my-key.keystore -alias my-key -keyalg RSA -keysize 2048 -validity 10000

2. In mobile/android/gradle.properties add the password you used to generate your keystore from the last step to both the MYAPP_RELEASE_STORE_PASSWORD and MYAPP_RELEASE_KEY_PASSWORD entries. Edit the MYAPP_RELEASE_KEY_ALIAS entry if you chose a different alias when running the keytool command.

3. Now, to generate the APK, make sure you are in mobile/android, then run:

   • ./gradlew assembleRelease for Mac/Linux
   • gradlew assembleRelease for Windows

4. Done! You'll find the APK at mobile/android/app/build/outputs/apk/app-release.apk!

Installing the APK

1. Allow unknown apps by doing(these steps might be different depending on your device):

   1. Go into Settings.
   2. Tap Security (or Lock Screen and Security).
   3. Scroll down to the Device Administration section, and enable Unknown Sources.

2. Download the APK to the device(either using Google Drive or another method).

3. If a pop-up comes up saying "This type of file can harm your device," accept it.

4. Tap the downloaded APK file and tap Install.

5. The app should now show up in the app library as IHC EMR.