Newly Paranoid Maintainers

    com.lampa.startapp

    6.1.6 • Public • Published

    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 previos 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.

    Install

    npm i com.lampa.startapp

    DownloadsWeekly Downloads

    590

    Version

    6.1.6

    License

    MIT

    Unpacked Size

    148 kB

    Total Files

    17

    Last publish

    Collaborators

    • lampa