Awesome
Cordova app troubleshooting guide
LICENSE: CC0 (public domain) ref: http://creativecommons.org/publicdomain/zero/1.0/
Inspiration:
Purpose
TBD
General
- Check brodybits / Cordova-quick-start-checklist
- In case of problems start with a fresh, clean project, follow brodybits / Cordova-quick-start-checklist, and try one thing at a time to isolate and pinpoint the exact issue and cause
General pitfalls
- Whitelist (see below)
- Attempting to use any Cordova or Cordova plugin functionality before receiving
deviceready
event - In case of ngCordova/Ionic, possible controller/factory/service/??? callbacks before
deviceready
event - TBD ...
Whitelist/security pitfalls
- intent whitelist: blocked intent such as external URL intent may cause certain Cordova plugin(s) to misbehave (see litehelpers / Cordova-sqlite-storage#396)
- navigation & network request whitelist
- Content Security Policy in index file
- In case of multi-page apps, each navigation HTML page MUST have the correct Content Security Policy config
ngCordova/Ionic-specific pitfalls
- possible controller/factory/service/??? callbacks before
deviceready
event - as discussed in litehelpers / Cordova-sqlite-storage#355 and https://forum.ionicframework.com/t/keyboard-error-and-cordova-plugins/39851, it may be necessary to add ionic-plugin-keyboard for certain plugins such as litehelpers / Cordova-sqlite-storage to work
SQLite-specific pitfall(s)
TBD (already documented in litehelpers / Cordova-sqlite-storage)