ringcentral-embeddable-mobile's Introduction

RingCentral embeddable mobile

Experimental Android/IOS apps based on ringcentral-embeddable and cordova

Download apps

https://github.com/ringcentral/ringcentral-embeddable-mobile/releases

todos

Running in Android
Running in IOS
Use web worker
Deploy to github pages

Dev

Prerequisites

Android: Follow the cordova guide to prepare for Android development: https://cordova.apache.org/docs/en/latest/guide/platforms/android/index.html
IOS: Follow the cordova guide to prepare for ISO development: https://cordova.apache.org/docs/en/latest/guide/platforms/ios/index.html, also requires paid apple developer account.
ImageMagick installed (Mac: brew install imagemagick, Debian/Ubuntu: sudo apt-get install imagemagick, Windows: See here, install "Legacy tools")
cordova-splash: npm install cordova-splash -g
cordova-icon: npm install cordova-icon -g

# clone project
git clone [email protected]:ringcentral/ringcentral-embeddable-mobile.git
cd ringcentral-embeddable-mobile

# install dependencies
npm i

# start proxy server
npm run proxy

# will get https://xxxx.ngrok.io -> localhost:6066
# Remember https://xxxx.ngrok.io as serverUrl

# create env file, then fill .env with serverUrl as RINGCENTRAL_APP_SERVER and RINGCENTRAL_CLIENT_ID and RINGCENTRAL_CLIENT_SECRET if you have
cp sample.env .env

# start server
npm start

# start client
npm run c

# prepare cordova
npm run prepare

# run Android app, make sure you have simulator or real android device ready
npm run a

# run IOS app, make sure you have real IOS device and paid developer ID ready,
# and open platforms/ios with xcode and config build an debug env
npm run i

Build for Github pages

# build for github pages, remember to push to github
npm run gh

# build for android
npm run build-android

# check platforms/android/app/build/outputs/apk/debug/app-debug.apk

# Build with online resources for IOS App
npm run build-ios