Cordova

introduction using the native ios/android webview implies some extra setup in your cordova project this setup involves incorporating the intelliprove mobile sdk as a pre packaged cordova plug in and adding the necessary bridging code all this is nicely laid out in our step by step guide below the integration guide covers two sections setting up the cordova plug in interfacing with the native code from cordova ( bridging ) github our github repository provides a fully functional example of our platform's integration, demonstrating the seamless setup and utilisation of our pre packaged cordova plug in https //github com/intelliprove/intelliprove web plugin cordova https //github com/intelliprove/intelliprove web plugin cordova minimal requirements for this guide, we assume a minimal 'hello world' application generated by the cordova project initialisation 1\ cordova plug in setup adding the framework last update 30/04/2025 18 15 https //archbee doc uploads s3 amazonaws com/ 0r dnpmbbllxmaowvg2u/1md6laexfch1puiszj2pn cdv intelliprovewebview 010 tgz copy the cdv intelliprovewebview x x x tgz tarball into your cordova app root directory and unpack it in your cordova app root directory, execute cordova plug in add /path/to/unpacked/tarball configuration for android/ios the cordova plug in already defines parameters to be added to ios's info plist, and android's manifest, such as which permissions are needed, what deployment target is needed, so no additional configuration should be needed 2 cordova integration while many possibilities exist to bridge the gap between native ios/android and cordova, this document serves as a guide to integrating the intelliprovesdk into a cordova application project to be able to call functions on, and receive callbacks from the intelliprove cordova plug in, we need to add code in the cordova application open index js or wherever in the cordova app that the intelliprove web view will be used add a callback to the deviceready event in that callback, add an event listener for a click, in which we'll open the web view through the intelliprove cordova plug in the url to open the intelliprove face scan plug in (webapp) is also added here in our example, it is added on a button click make sure to request the url for the face scan plug in using the rest api docid\ biupvixvhltbukklr2ati api endpoint on that plug in function call, we'll add a callback to receive 'postmessage' messages from the web view the post messages allow you to track the progress of the face scan and obtain the results from the intelliprove plug in immediately after the user has performed the face scan this allows you to use the results in your mobile app, enabling you to link actions to the results or design a custom results screen you can find an overview of the different types of messages on the message events docid\ kz6xsnd6v4g8efcgd02ib page document addeventlistener('deviceready', ondeviceready, false); function ondeviceready() { // add callback to intelliprove native module for presenting the intelliwebview document getelementbyid('openwebviewbutton') addeventlistener('click', function () { const url = "https //\<subdomain> intelliprove com/ "; if (cordova plugins && cordova plugins cdvintelliprovewebview && cordova plugins cdvintelliprovewebview\ presentwebview) { cordova plugins cdvintelliprovewebview\ presentwebview(url, function postmessagecallback(postmessage) { // handle the received postmessage console log('cdv postmessage full body ', postmessage); try { // the postmessage is received as a json string, so we need to parse it const parsedmessage = json parse(postmessage); if (parsedmessage && parsedmessage stage) { console log('cdv postmessage stage ', parsedmessage stage); } else { console warn('cdv invalid postmessage format ', parsedmessage); } } catch (error) { console error('cdv error parsing postmessage ', error); } }, function errorcallback(err) { console error("failed to open webview ", err); } ); } else { console warn("cdvintelliprovewebview\ presentwebview is not available "); } }); } also add a callback handler for receiving 'postmessage' messages finally, in index html we assign the openwebviewbutton button to whatever the entry point to the webview should be intelliprovewebview cordova example open webview the webview is automatically dismissed by the sdk when receiving the dismiss post message now run the application as you normally would (assuming cordova is installed as a ruby gem), for example bundle exec cordova clean ios or bundle exec cordova clean android bundle exec cordova build ios or bundle exec cordova build android bundle exec cordova run ios or bundle exec cordova run android next steps to match the plug in with your brand's colours and fonts, please visit our white labelling docid\ vzz odplrstmbhthzklld documentation