cordova-plugin-inappbrowser-popup-bridge
This is a fork of cordova-plugin-inappbrowser which adds support for Braintree's PopupBridge libraries for Android and iOS to support PayPal payments within the context of the InappBrowser element of a Cordova-based app.
The purpose of PopupBridge is to allow Webviews to open emulated popup windows in a browser and send data back to the parent page in the Webview. This is essential for Web-based PayPal checkout flows which use the Braintree JS SDK which supports popup emulation via PopupBridge.
See the example app project which demonstrates usage of cordova-plugin-inappbrowser-popup-bridge.
Installation
cordova plugin add cordova-plugin-inappbrowser-popup-bridge
iOS:
- PopupBridge requires WKWebView.
- Therefore, this plugin depends on cordova-plugin-wkwebview-engine which adds WKWebView support to Cordova.
- You need to add this manually:
cordova plugin add cordova-plugin-wkwebview-engine - Or you can use the Ionic variant:
cordova plugin add cordova-plugin-ionic-webview
- You need to add this manually:
- This means the main Cordova app Webview will also use WKWebView on iOS 9+.
Supported platform versions
- This plugin officially supports iOS 9.0+ and Android 4.4+
- These are the versions supported by PopupBridge
- However, this plugin will compile on iOS 8.0+ and Android 4.1+
- When running on earlier versions on which PopupBridge is not supported, it is the responsibility of the app which uses this plugin how it should behave.
- For example, fall back to launching the system browser instead of in-app browser. This means the user is taken out of the original app to the default browser app, but at least can fulfill their PayPal payment before manually navigating back to the original app.
Example app
cordova-plugin-inappbrowser-popup-bridge-test contains a Cordova project which builds a test app for Android and iOS to illustrate usage of this plugin.