Getting Started

Preliminary GitHub Setup

1.  first create an account on github.com if you don't already have one
   

2.  login to github
   

3.  visit https://github.com/ml5174/sacpcp and fork the main source repo
   

4.  visit https://github.com/ml5174/savi-lib fork the library source repo
   

Development Environment Setup

Development Environment Setup - Preliminary

1.  install LTS build of node from https://nodejs.org/en/download/  
   

2.  Clone from your sacpcp fork:
    git clone https://github.com/githubusername/sacpcp.git
    where githubusername is your username on github
    and the path given to clone is for your sacpcp fork
   

3.  cd sacpcp
   

4.  cd src
   

5.  Clone from your savi-lib repo into a subfolder of src:
    git clone https://github.com/githubusername/savi-lib.git lib
    where githubusername is your username on github
    and the path give to clone is for your lib fork
    NOTE: your lib subfolder of src needs to be named lib
    If you failed to give the lib argument as target name, then rename the lib folder to lib
   

Development Environment Setup - Secondary

1.  At this point you could run Thaddeus's npm command:
    npm run setup https://github.com/githubusername/sacpcp.git
    where githubusername is your username on github
    See npm_setup.md for more information
   

2.  -OR- do the detailed steps that follow:
   

3.  cd lib
   

4.  Set the upstream master for lib:
    git remote add upstream https://github.com/ml5174/savi-lib.git
   

5.  git checkout master
   

6.  git pull upstream master
   

7.  cd ../..
   

8.  Set the upstream master for the main source:
    git remote add upstream https://github.com/ml5174/sacpcp.git
   

9.  git checkout master
   

10.  git pull upstream master
    

11.  Once you cloned the repo to your desktop and have node installed you need to cd to the project and type:
     npm install
    

12.  Now install cordova and ionic. if on macOS, you may need to prefix this command with sudo and add --unsafe-perm=true as install option:<br>
     npm install -g cordova@latest
     npm install -g ionic@latest
     npm install -g @ionic/cli-utils@latest
     npm install @ionic/app-scripts@latest
    

Launching the application

• If all went well, you should be able to launch the application to your default browser:
  ionic serve

• If on macOS, then try adding ios platform:
  ionic cordova platform add ios

• You may also try adding android platform:
  ionic cordova platform add android

If having issues, then check your software installation versions with ionic info and npm --version output:

cli packages: (/usr/local/lib/node_modules)

@ionic/cli-plugin-proxy : 1.5.4
@ionic/cli-utils : 1.17.0
ionic (Ionic CLI) : 3.17.0

global packages:

cordova (Cordova CLI) : 7.1.0

local packages:

@ionic/app-scripts : 3.0.0
Cordova Platforms : android 6.3.0 ios 4.5.2
Ionic Framework : ionic-angular 3.7.1

System:

Android SDK Tools : 26.1.1
ios-deploy : 1.9.2
ios-sim : 6.1.2
Node : v8.6.0
npm : 5.5.1
OS : macOS Sierra
Xcode : Xcode 9.1 Build version 9B55

Environment Variables:

ANDROID_HOME : /Users/ms8342/Library/Android/sdk
HTTP_PROXY : not set
http_proxy : http://one.proxy.att.com:8080
HTTPS_PROXY : not set
https_proxy : https://one.proxy.att.com:8080
IONIC_HTTP_PROXY : not set
PROXY : not set
proxy : not set

Misc:

backend : legacy

Android SDK Tools is given above because ANDROID_HOME environment variable is set

See CONTRIBUTING.md for detailed git operations where developers follow a preferred workflow with pull requests to upstream master coming from their github forks and managing branches, including master, on both their fork from which the pull requests originate as well as their local working copy