Phonegap plugin for check or launch other application in android device.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 8331860 Jun 29, 2018
Permalink
Failed to load latest commit information.
src add support java 1.6 Jun 1, 2018
tests update tests Apr 5, 2016
www 6.1.4 May 24, 2018
.fetch.json Update .fetch.json Jan 20, 2015
LICENSE.md Update LICENSE.md Feb 4, 2015
MANUALLY_INSTALL.md update package May 16, 2018
README.md fix typo Jun 29, 2018
package.json add support java 1.6 Jun 1, 2018
plugin.xml add support java 1.6 Jun 1, 2018

README.md

cordova plugin startapp

Phonegap plugin for check or launch other application, get extras in phonegap app.

Last version 6.1.6

  • Add support java 1.6
  • Add support java 1.7
  • Add full support activityForResult, sendBroadcast and RegisterReceiver.
  • Add types of extras.

Install

Install: cordova plugin add com.lampa.startapp

Install: cordova plugin add https://github.com/lampaa/com.lampa.startapp.git

Delete: cordova plugin rm com.lampa.startapp

Delete previous version: cordova plugin rm org.apache.cordova.startapp

Manually installation for Android.

NEW! Script builder. Create script with UI builder.

ANDROID

To run other application, you need to build data:

var sApp = startApp.set({} params [, {} extras]);
Param Description Default Values
noParse Disable find action and category in Intent package false Boolean
intent Intent(String action) null String
application Intent (Context packageContext) null String
action Intent setAction null String
category Intent addCategory null String
type Intent setType null String
package Intent setPackage null String
uri Intent Uri null String
flags Intent setFlags null String
component Intent setComponent null String
intentstart set type of start intent startActivity startActivity, startActivityForResult, sendBroadcast

Extras as a set of key-value:

{
    "key1": "value1", // String
    "key2": "value2", // String
    "key3": 100, // Integer,
    "key4": true // Boolean
}

Example

var sApp = startApp.set({ /* params */
	"action":"ACTION_MAIN",
	"category":"CATEGORY_DEFAULT",
	"type":"text/css",
	"package":"com.lampa.startapp",
	"uri":"file://data/index.html",
	"flags":["FLAG_ACTIVITY_CLEAR_TOP","FLAG_ACTIVITY_CLEAR_TASK"],
	"component": ["com.app.name","com.app.name.Activity"],
	"intentstart":"startActivity",
}, { /* extras */
	"EXTRA_STREAM":"extraValue1",
	"extraKey2":100500
});

startApp.set() return object:

sApp.start(function() { /* success */
	console.log("OK");
}, function(error) { /* fail */
	alert(error);
}, function() { // optional broadcast and forResult callback
	console.log(arguments);
});

or

sApp.check(function(values) { /* success */
	console.log(values);
}, function(error) { /* fail */
	alert(error);
});

If success, values contains data: versionName, packageName, versionCode and applicationInfo.

To get all extra fields use method extraFiels:

startApp.extraFields(function(fields) { /* success */
	console.log(fields);
}, function() { /* fail */

});

Variable fields contains object array, example:

{
	"extraKey1":"extraValue1",
	"extraKey2":"extraValue2"
}

To get one extra field use method getExtra:

startApp.getExtra(field, function(value) { /* success */
	console.log(fields);
}, function() { /* fail */

});

Variable field is a String. Variable value contains String value.

To has one extra field use method extraField:

startApp.hasExtra(field, function() { /* success */
	console.log(fields);
}, function() { /* fail */

});

Variable field is a String.

Samples

Set application as only package name:

var sApp = startApp.set({
	"application":"com.application.name"
}).start();

Set application as intent value and flag (issue):

var sApp = startApp.set({
	"intent": "com.shazam.android.intent.actions.START_TAGGING",
	"flags": ["FLAG_ACTIVITY_NEW_TASK"]
}).start();

Set application as package and activity:

var sApp = startApp.set({
	"component": ["com.app.name","com.app.name.Activity"]
}).start();

Set application as action, package, type and Uri:

var sApp = startApp.set({ /* params */
	"action":"ACTION_MAIN",
	"type":"text/css",
	"package":"com.lampa.startapp",
	"uri":"file://data/index.html"
}).start();

Start application with extra fields

var sApp = startApp.set({ /* params */
	"component": ["com.app.name","com.app.name.Activity"]
}, { /* extras */
	"extraKey1":"extraValue1",
	"extraKey2":"extraValue2"
}).start();

Start listening broadcast

var sApp = startApp.set(["RECEIVER_NAME"]);

sApp.receiver(function(compete) { // if receiver is registered
	$messages.prepend("<div>id broadcast: " + compete + "</div>");
}, function(error) {
	$messages.prepend("<div class='err'>" + error + "</div>");
}, function(action, extras) { // receiver message
	$messages.prepend("<div>" + action + ", " + JSON.stringify(extras)  + "</div>");
});

Start application with result

var sApp = startApp.set({
	"action":"ACTION_MAIN",
	"package":"com.lampa.startapp",
	"intentstart":"startActivityForResult",
});

sApp.start(function(compete) { // if receiver is registered
	console.log(compete);
}, function(error) {
	console.error(error);
}, function(result, requestCode, resultCode) { // result message
	$messages.prepend("<div>" + JSON.stringify(result) + ", " + requestCode + ", " + resultCode + "</div>");
});

Send broadcast

var sApp = startApp.set({ /* params */
	"action":"RECEIVER_NAME",
	"intentstart":"sendBroadcast",
	"noParseAction": true // disable parse action value
}, {
	"extraKey1":"extraValue1",
	"extraKey2":"extraValue2"
});

sApp.start(function(compete) {
	console.log(compete);
}, function(error) {
	console.error(error);
});

Example, call skype:

startApp.set({ /* params */
	"action": "ACTION_VIEW",
	"uri": "skype:+79109999999"
}).start();

Example, call phone:

startApp.set({ /* params */
	"action": "ACTION_CALL",
	"uri": "tel:+79109999999"
}).start();

Example, call browser:

startApp.set({ /* params */
	"action": "ACTION_VIEW",
	"uri": "https://github.com/lampaa"
}).start();

Example, call facebook:

startApp.set({ /* params */
	"action": "ACTION_VIEW",
	"uri": "fb://facewebmodal/f?href=https://www.facebook.com/GitHub"
}).start();

Example, call whatsapp:

startApp.set({ /* params */
	"action": "ACTION_SEND",
	"package": "com.whatsapp",
	"type": "text/plain"
}, {
	"android.intent.extra.TEXT":"Text..."
}).start();

Example, call whatsapp chat:

startApp.set({ /* params */
	"action": "ACTION_SEND",
	"package": "com.whatsapp",
	"type": "text/plain",
	"uri": "+79123456789"
}, {
	"EXTRA_TEXT":"Text...",
	"chat": true
}).start();

Example, call sms:

startApp.set({ /* params */
	"action": "ACTION_MAIN",
	"category": "CATEGORY_DEFAULT",
	"type": "vnd.android-dir/mms-sms"
}).start();

Example, play mp4 video:

startApp.set({ /* params */
	"action": "ACTION_VIEW",
	"uri": "http://domain.com/videofile.mp4",
	"type": "video/mp4"
}).start();

Example, open contacts book:

startApp.set({ /* params */
	"action": "ACTION_PICK",
	"uri": "ContactsContract.Contacts.CONTENT_URI",
	"intentstart":"startActivityForResult"
}).start();

Example, open twitter:

startApp.set({ /* params */
	"application": "com.twitter.android"
}).start();

Example, open twitter user:

startApp.set({ /* params */
	"action": "ACTION_VIEW", 
	"uri": "https://twitter.com/kremlinrussia"
}).start();

Example, add alarm to alarm manager:

var sApp = startApp.set({ /* params */
    "action":"android.intent.action.SET_ALARM",
    "noParseAction": true
}, {
    "android.intent.extra.alarm.MESSAGE":"New Alarm",
    "android.intent.extra.alarm.HOUR":17,
    "android.intent.extra.alarm.MINUTES": 30
});

sApp.start(function(success) {
    console.log(success);
}, function(error) {
    console.error(success);
});

Use iOS

Set iOS application

var sApp = startApp.set("twitter://");

return startApp object:

sApp.start(function() { /* success */
	console.log("OK");
}, function(error) { /* fail */
	alert(error);
});

or

sApp.check(function(values) { /* success */
	console.log(values);
}, function(error) { /* fail */
	alert(error);
});

=========================================== Tags:

Cordova start external application. Android open an external application. Phonegap start external application. Launching External Intents Works on Cordova. Android launch external activities. Android check app availability. Android launch application with parameters.