Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
3500:0800:0890 [2026/08/13 00:55] – removed - external edit (Unknown date) 127.0.0.13500:0800:0890 [2026/08/13 01:10] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +{{tag>}}
 +[<10>]
 +====== Using Javascript to integrate custom Cordova plugins for native mobile applications =====
  
 +Cordova plugins are components that provide access to some built-in features of mobile phones, (such as camera or contacts), for which there is no Javascript access. When components are integrated into the system these features become available through some special Javascript functions that the plugin makes available to the developer. Cordova plugins can only be used in native mobile applications.
 +
 +AwareIM integrates some Cordova plugins out-of- the-box and provides rule actions that activate them (for example, ''[[ref:a_f:a:mobile_push|MOBILE PUSH]]'' or ''[[ref:a_f:a:mobile_camera_snap_into|MOBILE CAMERA SNAP INTO]]''. However, there are many plugins around and it is impossible to integrate all of them into //**AwareIM**//.
 +
 +Still there is a way to do this by adding some custom Javascript to your application. The following section explains how to do it.
 +
 +This is the high level overview of what needs to be done:
 +
 +  - Study the documentation of the Cordova plugin to fully understand Javascript methods that it exposes
 +  - Write the Javascript that calls the appropriate Javascript function that the plugin provides 
 +    - Give this function the data obtained from AwareIM if necessary. For example, read the data from the database and provide this data to the function of the plugin. The useful //**AwareIM**// function that can be used here is ''AwareApp.getObjectData()''
 +    - Handle the return of this function if necessary – for example write the data returned by the function to the database. Useful AwareIM functions for this are ''AwareApp.createOrUpdateObject()'' and ''AwareApp.startProcessWithInit()''
 +  - Define panel operations or menu items in the mobile part of your business space version (using the Configuration Tool) that would run this Javascript. You should select an operation or menu item of the "Execute Javascript" type for this.
 +  - Build a native mobile application for your business space version using the "Build Native Mobile Application" command in the Configuration Tool. This will create a zip file.
 +  - Uzip this zip file somewhere. Find the ''config.xml'' file in the root of the unzipped application and open it for editing.
 +  - Find the section in this file that lists the plugins used by the application, for example:''<plugin name="cordova-plugin-camera" spec="2.0.0"/>''\\ Add the definition of the Cordova plugin you need to integrate – look up the documentation of the plugin for details of the plugin name and version number
 +  - Zip up the application again and use the PhoneGap build to create application files in the native format of the mobile phone
 +Let’s look at an example. We will be integrating a Cordova plugin for Contacts into the CRM mobile sample application.
 +
 +The documentation of the plugin can be found here: [[https://github.com/apache/cordova-plugin-contacts|https://github.com/apache/cordova-plugin-contacts]]
 +
 +As we can see the plugin provides the navigator.contacts object that can be used to create contacts, find existing contact or pick a particular one. Let’s add the following functionality to the CRM application:
 +
 +  * From the form of a customer or from a customer list create a phone contact populated with the information from the customer record in the application
 +  * Pick a contact from the list of phone contacts and send this contact an email that includes some information stored in the application
 +
 +{{simplenavi>.:0890}}