cordova-plugin-inappbrowser-popup-bridge v5.0.2

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
• This means the main Cordova app Webview will also use WKWebView on iOS 9+.

Supported platform versions

The following supported platform versions are based on the versions suppored by the Braintree PopupBridge libraries.

Android

• Requires cordova-android@10+
• Requires Gradle v7.1.1 or above
• Supports Android 5.0 / API 21 and above
• Since v5, requires the Cordova activity to run as singleTask
  • Add <preference name="AndroidLaunchMode" value="singleTask" /> to <platform name="android"> in config.xml

iOS

• Requires cordova-ios@6+
• Supports iOS 9.0+

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.