lwc:programming:mobile:cordova_phonegap [wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
Notes on v 3.4.0:

Make all of your changes in the parent directory that all platforms will reference. Then build your code for the specific platform. Here's a nice shortcut:

cordova emulate --target="ipad (retina)"

will rebuild the code, then run on the simulator

cordova run ios

will rebuild the code, the load on the device. Because of a bug you need to run the app on the device manually.

  * If things aren't rebuilding right regarding plugins,[[http://stackoverflow.com/questions/18403225/phonegap-3-0-ios-plugins-not-found|this script]] might help
  * can we just forget about PG and use Cordova only? :-)

Disable status bar:

  * phonegap local plugin add https:%%//%%github.com/phonegap-build/StatusBarPlugin.git 
  * view [[https://github.com/phonegap-build/StatusBarPlugin/blob/afcb704993513e074466a2830aa82f50621d81c7/README.md|these docs]]
  * bizarrely, the plugin successfully hides the status bar but reports it still visible?

Get console log info:
  * phonegap local plugin add https:%%//%%git-wip-us.apache.org/repos/asf/cordova-plugin-console.git

Know what device you are on:
  * cordova plugin add org.apache.cordova.device

Media:

  * cordova plugin add https:%%//%%git-wip-us.apache.org/repos/asf/cordova-plugin-media.git
  * cordova plugin add org.apache.cordova.file (yes you need this for media to work or you get a CDVfile error not found)

Pause Event (iOS):

  * console.log actually does work on a pause event
  * both sessionStorage and localStorage will not be called on a pause event until after the resume
  * fileAPI (native plugin) will not be called on pause event consistently until after resume

Storage:
  * localStorage will persist of app is killed, but sessionStorage will not
  * both localStorage and sessionStorage have a quota of 5MB on iOs

[[http://stackoverflow.com/questions/1248081/get-the-browser-viewport-dimensions-with-javascript|Width and height]]

==== Updating Plugins ====

cordova-update-plugins is a plugin to check and optionally make sure all plugins are updated:
  * install: sudo npm install -g cordova-check-plugins
  * check: cordova-check-plugins
  * update: cordova-check-plugins --update=auto

===== Running on Android =====

  * To accept licenses:

===== Creating a release version: Android =====

//This process (keytool, jarsigner, zipalign) was still required as of Cordova 9.0 April 2020//

generate keystore file if it doesn't already exist. In the root directory of the project (parent of www): "keytool -genkey -v -keystore <APPNAME>.keystore -alias <APPNAME> -keyalg RSA -keysize 2048 -validity 10000"
edit /platforms/android/AndroidManifest.xml so that debuggable is set to false
  * update: as of Cordova 5.x you can't hardcode debuggable anymore. If you really want to (for example debuggable = true with release (for inapp purchase testing)) edit  platforms/android/build.gradleand add in the android { section: 
<code>
lintOptions {
    checkReleaseBuilds false
}
</code>
  * note: you **must** use the same keystore file for all versions of the same app


To build for release: "cordova build android --release"

As of Cordova 5 you seem to need to run the keysigner separately. The keysigner will sign an existing file. It does not write a new file:

  * Format:  jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore <APPNAME>.keystore <PATH_TO_APK_FILE>.apk <APPNAME>
  * Example: jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore ~/SnappyKids/lavaLevel/lavaLevel.keystore android-armv7-release-unsigned.apk lavaLevel

After running the jarsigner it is necessary to run the zip align tool:
  * Format: zipalign -v 4 <signed.apk> <zip-aligned-signed-apk>
  * Example: /home/user/dev/android-sdk-linux/build-tools/23.0.1/zipalign -v 4 platforms/android/build/outputs/apk/android-release-signed.apk platforms/android/build/outputs/apk/android-release.apk

==== Splash Screen ====
  * Generate Automatically: http://ticons.fokkezb.nl/