VESS

This application allows to perform a Visual Evaluation of Soil Structure (VESS) test [Ball et al. 2007, Guimaraes et al. 2011].

Installation

Install NodeJS.
Install Ionic.
Clone this repository: git clone https://github.com/MichaelPolla/VESS.git.
Go into the app folder (cd /vess/app) and run npm install.

Mac: if you get the message gyp: No Xcode or CLT version detected!, you to need to execute this command line before npm install: sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer/

Build & Run

Browser

This is the easiest way to try the app. However please note that not all functionalities will be available (e.g. the Camera will not be accessible).

Open the app folder
Run ionic serve or ionic serve --lab

Android build

For complete instructions, see the Cordova Android Platform Guide.
In summary:

Install Java Development Kit (JDK) 8
Install Gradle.
Install Android Studio. This will also install the Android SDK.
Run: ionic cordova run android. This will build and run the app on a connected device, or will start the Android emulator.

iOS build

XCode must be installed.

Install ios-deploy: npm install -g ios-deploy
Build and run on emulator or connected device: ionic cordova run ios

Troubleshooting

Android build error

Android build: if you keep getting the following message although Android Studio is already installed:

UnhandledPromiseRejectionWarning: CordovaError: Could not find an installed version of Gradle either in Android Studio,
or on your system to install the gradle wrapper. Please include gradle
in your path, or install Android Studio

=> Install Gradle.

iOS build error

if npm install ios-deploy -g fails, run:
sudo npm install --global --unsafe-perm ios-deploy (as suggested here)

If you need to completely clean XCode cache, delete all the content of Library/Developer/Xcode/DeriveData/

MichaelPolla/VESS