Building Locally

Owned by Ben St John
Last updated: Feb 04, 2021
2 min read

This document will show you how to install and run the LA version of the PathCheck GAEN app.

Firstly, install the project from here

If you get stuck at any point in the onboarding process, refer to this document or check the PathCheck development documentation

 

Once the project is installed, cd into the project’s main directory and run the command “yarn install” to install the project dependencies to your local machine.

 

Make sure you have Android Studio installed as well as ADB to run the android emulator later on. 

 

Next, run the setup script for your environment 

$ chmod +x bin/dev_setup.sh && ./bin/dev_setup.sh

 

Add your github token to the .env file. You’ll need to now run “bin/set_ha.sh ${HA_LABEL}” where HA_LABEL is the label for the health authority you’re testing. For this example, we’re going to be using LA.

 

This error is common: “Failed fetch” when attempting to run ./bin/set_ha.sh {HA}

You need to contact one of the main repository developers in order to get credentials to run that command.

 

Now… you’ll need to configure your ruby (rvm, pods, gem, etc) environment to work with the project. 

 

If on Mac, install “brew install gnupg2” with brew. You’ll need it to install the RVM (ruby virtual machine)

 

Next, run this command: “gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3” 

 

This will pull a verified RVM download from a trusted source, the key belongs to the project’s creator and is trusted. 

 

After that, attempt to run this command: \curl -sSL https://raw.githubusercontent.com/rvm/rvm/master/binscripts/rvm-installer | bash -s stable

 

For me it didn’t work so I need to run these:

$ \curl -sSL https://get.rvm.io | bash

$ source /Users/{your-user}/.rvm/scripts/rvm 

$ rvm install "ruby-2.6.5"

 

Note: If the last command fails for you, you might need to update your brew instance. Do that via “brew update” and if it yells at you that it’s a shallow clone, follow the command brew provides to update it properly. This will take a few minutes, go grab a coffee.

 

You should have the proper ruby version installed. Try running “yarn install:pod” to install your pods to the project.