https://github.com/lampaa/com.lampa.startapp
Phonegap plugin for check or launch other application in android device.
https://github.com/lampaa/com.lampa.startapp
android java javascript phonegap phonegap-plugin startapp
Last synced: about 2 months ago
JSON representation
Phonegap plugin for check or launch other application in android device.
- Host: GitHub
- URL: https://github.com/lampaa/com.lampa.startapp
- Owner: lampaa
- License: mit
- Created: 2013-09-26T11:34:23.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2021-03-15T10:23:37.000Z (about 4 years ago)
- Last Synced: 2025-03-28T19:09:33.344Z (about 2 months ago)
- Topics: android, java, javascript, phonegap, phonegap-plugin, startapp
- Language: Java
- Homepage:
- Size: 170 KB
- Stars: 229
- Watchers: 19
- Forks: 120
- Open Issues: 45
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 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.](/MANUALLY_INSTALL.md)
**NEW!** [Script builder.](http://lampaa.github.io/com.lampa.startapp/index.html) 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)](https://developer.android.com/reference/android/content/Intent.html#Intent%28java.lang.String%29) | null | String |
| application | [Intent (Context packageContext)](https://developer.android.com/reference/android/content/Intent.html#Intent%28android.content.Context,%20java.lang.Class%3C?%3E%29) | null | String |
| action | [Intent setAction](http://developer.android.com/reference/android/content/Intent.html#setAction(java.lang.String)) | null | String ||
| category | [Intent addCategory](http://developer.android.com/reference/android/content/Intent.html#addCategory(java.lang.String)) | null | String |
| type | [Intent setType](http://developer.android.com/intl/ru/reference/android/content/Intent.html#setType(java.lang.String)) | null | String |
| package | [Intent setPackage](http://developer.android.com/intl/ru/reference/android/content/Intent.html#setPackage(java.lang.String)) | null | String |
| uri | [Intent Uri](http://developer.android.com/intl/ru/reference/android/content/Intent.html#Intent(java.lang.String,android.net.Uri)) | null | String |
| flags | [Intent setFlags](http://developer.android.com/reference/android/content/Intent.html#setFlags(int)) | null | String |
| component | [Intent setComponent](http://developer.android.com/reference/android/content/Intent.html#setComponent(android.content.ComponentName)) | 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_
```javascript
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](https://github.com/lampaa/com.lampa.startapp/issues/50))_:
```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_
```js
var sApp = startApp.set({ /* params */
"component": ["com.app.name","com.app.name.Activity"]
}, { /* extras */
"extraKey1":"extraValue1",
"extraKey2":"extraValue2"
}).start();
```
_Start listening broadcast_
```js
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_
```js
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_
```js
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.