Skip to content

Latest commit

 

History

History

mobile

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
tess
tess
 
 
.nvmrc
.nvmrc
 
 
README.md
README.md
 
 

README.md

Required Software

a diff change

Install the following prescribed versions. You can possibly have a more-recent version of these, however, these are the versions we know are currently working.

app version install notes
node 8.12.0 Install using one of:
1. NVM: Node Version Manager (nvm) and explicitly install node8 the same way we do it in production: nvm install 8 - check which version we are running with cat ~/mobile/.nvmrc. You can set node8 as the default with nvm use 8.12
2. BREW: brew install node@8.12.0 or brew install node (this will install the latest version, which might not work) *
yarn 1.17.3 Use Homebrew via brew install yarn, or brew upgrade yarn if you already have it installed
watchman 4.9.0 brew install watchman
react-native-cli 2.0.1 yarn global add react-native-cli
Xcode 11.1 Apple App Store
Android Studio 3.5 React Native Android Studio Walkthrough
Java JDK 8+ JDK - 8
cocoapods 1.8.3+ https://guides.cocoapods.org/using/getting-started.html

Running the project

Get into the project

cd tess

Install the needed dependencies:

yarn install
cd ios
# sudo gem install cocoapods - if don't have pods yet
pod install

(You may need to open a new shell to ensure that the newly installed software is your environment PATH.)

Run instructions for iOS (assuming you are on the root dir of the repo):

cd SlacGismo/TESS/mobile/tess && npx react-native run-ios

or:

  • Open tess/ios/tess.xcworkspace in Xcode or run xed -b ios
  • Hit the Run button

If you get an error regarding simctl not being found, check out https://stackoverflow.com/questions/29108172/xcrun-unable-to-find-simctl for some ideas on how to fix it. Most likely Xcode->Preferences->Locations needs to have Command line tools set.

Run instructions for Android:

Have an Android emulator running (quickest way to get started), or a device connected. If you don't have a device to connect, you can try installing the emulator using CLI, e.g, https://medium.com/@rishii.kumar.chawda/install-android-emulator-for-react-native-app-without-installing-android-studio-727d7734528.

# Have an Android emulator running * (quickest way to get started), or a device connected.
cd SlacGismo/TESS/mobile/tess && npx react-native run-android

*The setup for an android virtual device is a little dense, and manual. Please follow the instructions here before attempting to run this RN project on an android sim: https://developer.android.com/studio/run/managing-avds