jinkebj/handynote-mobile

HandyNote Mobile App - support both Android & iOS

HandyNote Mobile

HandyNote Mobile App for iOS and Android, utilize HandyNote-Service as backend service provider

• Screenshot & HandyNote overall info

Software Requirements

• Node.js 8.x or above

Development Setup & debug on browser

# Optional, set npm mirror to speed up npm install in China
npm config set registry https://registry.npm.taobao.org

# install cordova globally
npm install -g cordova

# install dependencies
npm install

# Optional, set HANDYNOTE_SERVICE_API
# if not set, will use HANDYNOTE_SERVICE_API=http://localhost:3000/api
# please refer to https://github.com/jinkebj/HandyNote-Service/blob/master/README.md to setup HandyNote-Service debug env
export HANDYNOTE_SERVICE_API=http://IP:Port/api

# run in debug mode with hot reload
npm run dev

# build for production with minification
npm run build

# build for production and view the bundle analyzer report
npm run build --report

Debug on android

1. Make sure android sdk is setup

• Install Java Development Kit (JDK) 8 or later
• Install android-sdk and open SDK Manager (by run android from the terminal)
• Make sure the following are installed: Android Platform SDK for your targeted version of Android Android SDK build-tools version 19.1.0 or higher Android Support Repository (found under "Extras")
• Set the JAVA_HOME & ANDROID_HOME environment variable, add the Android SDK's tools, tools/bin, and platform-tools directories to PATH

2. Make sure cordova android support is added

cordova platform add android

3. Enable USB debugging and Developer Mode on Android device

npm run android

Debug on iOS

1. Make sure required app is setup

• Install xcode, xcode-select and ios-deploy

  xcode-select --install
  npm install -g --unsafe-perm=true ios-deploy

2. Make sure cordova iOS support is added

cordova platform add ios

3. Generate Xcode project file

cordova build ios

• Open Xcode project file, use apple id to set up a provisioning profile to code sign the app

4. Run the following command and trust the certificate on iOS device

npm run ios