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:
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.
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 |
matchDoubleInString | Match Double type in string extras (usefull for coordinates, prices etc.) | 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.
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",
"noParse": 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",
"noParse": 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(error);
});
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.