Merge remote-tracking branch 'origin/master'

# Conflicts:
#	README.md
This commit is contained in:
Лампуша
2016-04-05 13:57:42 +03:00
+126 -8
View File
@@ -1,17 +1,21 @@
cordova plugin startapp # cordova plugin startapp
===========================================================================
Phonegap plugin for check or launch other application in android device. Phonegap plugin for check or launch other application, get extras in phonegap app.
=========================================== > Install: ```cordova plugin add com.lampa.startapp```
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```
Install: ```cordova plugin add https://github.com/lampaa/com.lampa.startapp.git``` [Manually installation for Android.](/lampaa/com.lampa.startapp/MANUALLY_INSTALL.md)
Delete: ```cordova plugin rm com.lampa.startapp```
Delete previos version: ```cordova plugin rm org.apache.cordova.startapp``` **NEW!** [Script builder.](/lampaa/com.lampa.startapp/MANUALLY_INSTALL.md) Create script with ui builder.
<<<<<<< HEAD
=========================================== ===========================================
[Manually installation for Android.](/lampaa/com.lampa.startapp/MANUALLY_INSTALL.md) [Manually installation for Android.](/lampaa/com.lampa.startapp/MANUALLY_INSTALL.md)
@@ -23,6 +27,36 @@ use: **ANDROID**
_Set appication parameters_ _Set appication parameters_
=======
# ANDROID
To run other application, you need to build data:
```javascript
var sApp = startApp.set({} params [, {} extras]);
```
| Param | Description | Default | Values |
| --- | --- | --- | --- |
| 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:
```javascript
{
"key1":"value1",
"key2":"value2"
}
```
_Example_
>>>>>>> origin/master
```javascript ```javascript
var sApp = startApp.set({ /* params */ var sApp = startApp.set({ /* params */
"action":"ACTION_MAIN", "action":"ACTION_MAIN",
@@ -30,15 +64,24 @@ var sApp = startApp.set({ /* params */
"type":"text/css", "type":"text/css",
"package":"com.lampa.startapp", "package":"com.lampa.startapp",
"uri":"file://data/index.html", "uri":"file://data/index.html",
<<<<<<< HEAD
"intentstart":"startActivity", "intentstart":"startActivity",
"flags":["FLAG_ACTIVITY_CLEAR_TOP","FLAG_ACTIVITY_CLEAR_TASK"], "flags":["FLAG_ACTIVITY_CLEAR_TOP","FLAG_ACTIVITY_CLEAR_TASK"],
"component": ["com.app.name","com.app.name.Activity"] "component": ["com.app.name","com.app.name.Activity"]
}, { /* extras */ }, { /* extras */
"extraKey1":"extraValue1", "extraKey1":"extraValue1",
=======
"flags":["FLAG_ACTIVITY_CLEAR_TOP","FLAG_ACTIVITY_CLEAR_TASK"],
"component": ["com.app.name","com.app.name.Activity"],
"intentstart":"startActivity",
}, { /* extras */
"EXTRA_STREAM":"extraValue1",
>>>>>>> origin/master
"extraKey2":"extraValue2" "extraKey2":"extraValue2"
}); });
``` ```
<<<<<<< HEAD
`action` these is a Intent action [Intent setAction](http://developer.android.com/reference/android/content/Intent.html#setAction(java.lang.String)) (optional, defaul null). `action` these is a Intent action [Intent setAction](http://developer.android.com/reference/android/content/Intent.html#setAction(java.lang.String)) (optional, defaul null).
`category` these is a Intent method [Intent addCategory](http://developer.android.com/reference/android/content/Intent.html#addCategory(java.lang.String)) (optional, defaul null). `category` these is a Intent method [Intent addCategory](http://developer.android.com/reference/android/content/Intent.html#addCategory(java.lang.String)) (optional, defaul null).
@@ -71,9 +114,68 @@ sApp.check(function(values) { /* success */
}); });
``` ```
If success, values contains data: `versionName`, `packageName`, `versionCode` and `applicationInfo`. If success, values contains data: `versionName`, `packageName`, `versionCode` and `applicationInfo`.
=======
```startApp.set()``` return 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);
});
```
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
{
"key1":"value1",
"key2":"value2"
}
```
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 */
>>>>>>> origin/master
});
```
Variable ```field``` is a String.
<<<<<<< HEAD
**Samples** **Samples**
=======
# Samples
>>>>>>> origin/master
_Set application as only package name_: _Set application as only package name_:
```js ```js
@@ -183,7 +285,10 @@ Example, open contacts book:
startApp.set({ /* params */ startApp.set({ /* params */
"action": "ACTION_PICK", "action": "ACTION_PICK",
"uri": "ContactsContract.Contacts.CONTENT_URI", "uri": "ContactsContract.Contacts.CONTENT_URI",
<<<<<<< HEAD
"type": "video/mp4", "type": "video/mp4",
=======
>>>>>>> origin/master
"intentstart":"startActivityForResult" "intentstart":"startActivityForResult"
}).start(); }).start();
``` ```
@@ -203,6 +308,7 @@ sApp.start(function() { /* success */
console.log("OK"); console.log("OK");
}, function(error) { /* fail */ }, function(error) { /* fail */
alert(error); alert(error);
<<<<<<< HEAD
}); });
``` ```
or or
@@ -213,6 +319,18 @@ sApp.check(function(values) { /* success */
alert(error); alert(error);
}); });
``` ```
=======
});
```
or
```javascript
sApp.check(function(values) { /* success */
console.log(values);
}, function(error) { /* fail */
alert(error);
});
```
>>>>>>> origin/master
=========================================== ===========================================
Tags: Tags: