git clone git@github.com:ushahidi/platform-mobile-app.git
cd platform-mobile-app
src/constants/secrets.ts.template
to /src/constants/secrets.ts
VIMEO_ACCESS_TOKEN
and MAPBOX_ACCESS_TOKEN
with your own keysDownload and install XCode
https://developer.apple.com/xcode/
Once XCode is installed, install the command line tools
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
sudo xcode-select --install
Check your version of GCC
gcc --version
Install Homebrew, if its not already installed
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Add the Homebrew location export PATH="/usr/local/bin:$PATH"
to your environment $PATH
.
open -e ~/.bash_profile
Update the Homebrew recipes
brew update
If you have permission issues with /usr/local/
, try running
sudo chown -R `whoami` /usr/local/
brew update
Check health of Homebrew recipes
brew doctor
Install Node via Homebrew
brew install node
Check the version of Node
node --version
Install some NPM utilities
NOTE: version 7.x not supported, stick to 6.x
npm install -g npm@6
Check the version of NPM
npm --version
Remove, Clean, Install
rm -rf node_modules/
npm install
Install the latest Cordova
npm install -g cordova@7.1.0
Check the version of Cordova
cordova -v
Clean up the Cordova build files
cordova clean
Install Ionic 4
npm install -g ionic@4
Install some Ionic and Cordova utilities
npm install -g xcode@^3.0
npm install -g ios-sim@^9
npm install -g ios-deploy@^11
npm install -g cordova-res@^0.15
npm install -g android-simulator@^0.1
Check the version of Ionic
ionic info
List the root level NPM packages
npm list --depth=0
To update the version of the ionic-angular package
npm install ionic-angular@latest --save --save-exact
npm install @ionic/app-scripts@latest --save-dev
Remove, Clean, Install
rm -rf node_modules/
npm install
Download and install the latest Java JDK
https://support.apple.com/kb/dl1572?locale=en_US
Check your version of Java
java -version
Download and install the latest Android Studio
https://developer.android.com/studio/index.html
Once installed, find the location where the Android SDK is installed
Android Studio > Preferences > Appearance & Behaviour > System Settings > Android SDK > Android SDK Location
Open your ~/.bash_profile
to include the location of the Android SDK
open -e ~/.bash_profile
Add the lines to the bottom of your ~/.bash_profile
, pointing to your Android SDK Location
(mine was /Library/Android
)
export PATH=/Library/Android/tools:/Library/Android/platform-tools:$PATH
export ANDROID_HOME=/Library/Android
export ANDROID_SDK=/Library/Android
export ANDROID_SDK_ROOT=/Library/Android
Test running the Android Command Line Tools
android --help
Update the necessary SDKs
android list sdk --all --extended
android update sdk -u -a -t android-24
android update sdk -u -a -t extra-android-m2repository
android update sdk -u -a -t extra-google-google_play_services
android update sdk -u -a -t extra-google-analytics_sdk_v2
android update sdk -u -a -t extra-intel-Hardware_Accelerated_Execution_Manager
Run Android SDK Manager
android sdk
Run Android Virtual Device Manager
android avd
Check whether the Cordova requirements for iOS are installed
cordova requirements ios
Build the project for iOS
ionic cordova build ios
Run the app in the iOS Simulator or attached iOS device
ionic cordova run ios --livereload --consolelogs --serverlogs
ionic cordova run ios --livereload --consolelogs --serverlogs --target "iPhone-SE"
ionic cordova run ios --livereload --consolelogs --serverlogs --target "iPad-Air-2"
Build the app in release and production mode for archiving
ionic cordova build ios --prod --release
More information on Cordova's iOS Platform Guide
https://cordova.apache.org/docs/en/latest/guide/platforms/ios/
Check whether the Cordova requirements for Android are installed
cordova requirements android
Build the project for Android
ionic cordova build android
Run the app in the Android Emulator or attached Android device
ionic cordova run android --livereload --consolelogs --serverlogs
Build the app in release and production mode for archiving
ionic cordova build android --prod --release
More information on Cordova's Android Platform Guide
https://cordova.apache.org/docs/en/latest/guide/platforms/android/
Check local changes
git status
Revert local changes
git reset --hard
Commit local changes
git add .
git add -u
git commit -m "message about the changes"
git push
Create a tag
git tag 1.0
git push origin --tags
Check outdated NPM dependencies
npm outdated
Update all dependencies to latest Ionic
npm install ionic-angular@latest --save --save-exact