com.lampa.startapp

by lampaa

Phonegap plugin for check or launch other application in android device.

203 Stars 117 Forks Last release: over 1 year ago (6.1.6) MIT License 130 Commits 3 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

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:

javascript
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:

js
{
    "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:
javascript
sApp.start(function() { /* success */
    console.log("OK");
}, function(error) { /* fail */
    alert(error);
}, function() { // optional broadcast and forResult callback
    console.log(arguments);
});
or
javascript
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
: ```javascript startApp.extraFields(function(fields) { /* success / console.log(fields); }, function() { / fail */

});

Variable
fields
contains object array, example:
javascript { "extraKey1":"extraValue1", "extraKey2":"extraValue2" } ```

To get one extra field use method

getExtra
: ```javascript 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
: ```javascript startApp.hasExtra(field, function() { /* success / console.log(fields); }, function() { / fail */

});

Variable
field``` is a String.

Samples

Set application as only package name:

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

Set application as intent value and flag (issue):

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

Set application as package and activity:

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

Set application as action, package, type and Uri:

js
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("

id broadcast: " + compete + "
"); }, function(error) { $messages.prepend("
" + error + "
"); }, function(action, extras) { // receiver message $messages.prepend("
" + action + ", " + JSON.stringify(extras) + "
"); });

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("

" + JSON.stringify(result) + ", " + requestCode + ", " + resultCode + "
"); });

Send broadcast ```js 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:

js
startApp.set({ /* params */
    "action": "ACTION_VIEW",
    "uri": "skype:+79109999999"
}).start();
Example, call phone:
js
startApp.set({ /* params */
    "action": "ACTION_CALL",
    "uri": "tel:+79109999999"
}).start();
Example, call browser:
js
startApp.set({ /* params */
    "action": "ACTION_VIEW",
    "uri": "https://github.com/lampaa"
}).start();
Example, call facebook:
js
startApp.set({ /* params */
    "action": "ACTION_VIEW",
    "uri": "fb://facewebmodal/f?href=https://www.facebook.com/GitHub"
}).start();
Example, call whatsapp:
js
startApp.set({ /* params */
    "action": "ACTION_SEND",
    "package": "com.whatsapp",
    "type": "text/plain"
}, {
    "android.intent.extra.TEXT":"Text..."
}).start();
Example, call whatsapp chat:
js
startApp.set({ /* params */
    "action": "ACTION_SEND",
    "package": "com.whatsapp",
    "type": "text/plain",
    "uri": "+79123456789"
}, {
    "EXTRA_TEXT":"Text...",
    "chat": true
}).start();
Example, call sms:
js
startApp.set({ /* params */
    "action": "ACTION_MAIN",
    "category": "CATEGORY_DEFAULT",
    "type": "vnd.android-dir/mms-sms"
}).start();
Example, play mp4 video:
js
startApp.set({ /* params */
    "action": "ACTION_VIEW",
    "uri": "http://domain.com/videofile.mp4",
    "type": "video/mp4"
}).start();
Example, open contacts book:
js
startApp.set({ /* params */
    "action": "ACTION_PICK",
    "uri": "ContactsContract.Contacts.CONTENT_URI",
    "intentstart":"startActivityForResult"
}).start();
Example, open twitter:
js
startApp.set({ /* params */
    "application": "com.twitter.android"
}).start();
Example, open twitter user:
js
startApp.set({ /* params */
    "action": "ACTION_VIEW", 
    "uri": "https://twitter.com/kremlinrussia"
}).start();

Example, add alarm to alarm manager: ```js 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:
javascript
sApp.start(function() { /* success */
    console.log("OK");
}, function(error) { /* fail */
    alert(error);
});
or
javascript
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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.