Phonegap Bridge Configuration file CIS 136 Building Mobile Apps

Configuration Bridges the Gap between your standard web technologies, and the unique capabilities inherent in your smartphone A platform agnostic XML file that controls many aspects of an app's behavior Defines global and platform-specific options core set of images for each target platform icons and splash screens If you do not specify an icon then the Apache Cordova logo is used Root element of the config file is the <widget>

Core components id: Specifies the app's reverse-domain identifier version: Full version number expressed in major/minor/patch notation versioncode: Alternative version for Android xmlns: Namespace for the config.xml document xmlns: gap Namespace prefix name: The app's formal name, as it appears on the device's home screen and within app-store interfaces description: Specifies metadata that may appear within app-store listings author: Specifies contact information that may appear within app-store listings content: The app's starting page in the top-level web assets directory. The default value is index.html

Origin policy access: Defines the set of external domains the app is allowed to communicate with. The default “*” allows it to access any server allow-intent: Controls which URLs the app is allowed to ask the system to open. By default, no external URLs are allowed platform: configurations that should only appear in a specific platform

Preferences options as pairs of name/value attributes http://devgirl.org/files/config-app/

Icons References to icons used in the app

Splash Screen

Plug-ins add-on code that provides JavaScript interface to native components In Phonegap, there is a minimal set and there are lots of 3rd party plug-ins to choose from, like Paypal http://node-modules.com/search?u=cordova&q=paypal+ecosystem%3Acordova Learning how and when to use the plug-in is key Requires writing Javascript/jQuery code https://cordova.apache.org/docs

Core plug-ins Battery Camera Console Contacts Device Accelerometer Compass Dialogs File System File Transfer Geolocation Globalization inApp Browser Media Media Capture Network Information Splashscreen Vibration StatusBar http://docs.phonegap.com/plugin-apis/

Beep, Alert, prompt, confirm Dialog Plugin Beep, Alert, prompt, confirm

Dialog Plugin Phonegap API provides ways to communicate with the user, using same approach as in traditional web design Alert window Prompt window Confirm window The dialog plugin provides access to these native dialog UI elements

Dialog Plugin Before accessing native features using the Phonegap API, must ensure that the phonegap container has finished initializing Use event listeners, and listen for when the device is ready

Dialog Plugin methods Four methods: navigator.notification.alert navigator.notification.confirm navigator.notification.prompt navigator.notification.beep

Beep method SYNTAX navigator.notification.beep(times); times: The number of times to repeat the beep. (Number)

Alert method – shows and alert dialog box SYNTAX: navigator.notification.alert(message, alertCallback, [title], [buttonName]) message: Dialog message. (String) alertCallback: Callback to invoke when alert dialog is dismissed. (Function) title: Dialog title. (String) (Optional, defaults to Alert) buttonName: Button name. (String) (Optional, defaults to OK)

Confirm method SYNTAX navigator.notification.confirm(message, confirmCallback, [title], [buttonLabels]) •message: Dialog message. (String) •confirmCallback: Callback to invoke with index of button pressed (1, 2, or 3) or when the dialog is dismissed without a button press (0). (Function) •title: Dialog title. (String) (Optional, defaults to Confirm) •buttonLabels: Array of strings specifying button labels. (Array) (Optional, defaults to [OK,Cancel])

Confirm Method confirmCallback (confirmDialog) executes when the user presses one of the buttons in the confirmation dialog box

Prompt method SYNTAX navigator.notification.prompt(message, promptCallback, [title], [buttonLabels], [defaultText]) message: Dialog message. (String) promptCallback: Callback to invoke with index of button pressed (1, 2, or 3) or when the dialog is dismissed without a button press (0). (Function) title: Dialog title (String) (Optional, defaults to Prompt) buttonLabels: Array of strings specifying button labels (Array) (Optional, defaults to ["OK","Cancel"]) defaultText: Default textbox input value (String) (Optional, Default: empty string)

Prompt Method The promptCallback (promptResponse) executes when the user presses one of the buttons in the prompt dialog box. The results object passed to the callback contains the following properties: buttonIndex: The index of the pressed button. (Number) Note that the index uses one-based indexing, so the value is 1, 2, 3, etc. input: The text entered in the prompt dialog box. (String)