A Cordova plugin to launch external applications from your application.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/ios
www/js
README.md
plugin.xml

README.md

External App Launcher

A Cordova plugin to launch external applications from your Cordova-based iOS application.
Compatible with Cordova >= 2.5.0

Steps to install

  1. Install cordova-plugman.
  2. cd into your project directory.
  3. Execute the following command:
plugman --platform ios --project . --plugin https://github.com/sbahal/external-app-launcher.git

Steps to uninstall

plugman --uninstall --platform ios --project . --plugin org.cordova.plugins.ExternalAppLauncher

Usage

externalApp.launch([appUrlScheme, storeUrl, alertMessage, alertType]);

where,
appUrlScheme: the URL scheme of the app that you wish to launch
storeUrl: the URL to be redirected to in case the external app is not found
alertMessage: the message to be displayed to the user in case the external app is not found
alertType: the type of alert to be presented to the user

  • externalApp.alertType.OK: to just display an alert message, or
  • externalApp.alertType.OK_CANCEL: to redirect the user to the specified store

Example

externalApp.launch(['com.foo.MyApp', '', 'Please download the latest version of this app from the store', externalApp.alertType.OK]);
externalApp.launch(['com.foo.MyApp', 'https://foo.com', 'Please download the latest version of this app from the store', externalApp.alertType.OK_CANCEL]);