cordova-plugin-run-in-backg.../README.md

78 lines
2.3 KiB
Markdown
Raw Normal View History

2013-10-08 08:51:17 +00:00
Cordova BackgroundMode-Plugin
2013-10-08 08:28:55 +00:00
==============================
2013-10-08 08:51:17 +00:00
A bunch of background mode plugins for Cordova 3.x.x
by Sebastián Katzer ([github.com/katzer](https://github.com/katzer))
## Supported Platforms
2013-10-08 14:39:40 +00:00
- **iOS** (>=5)
2013-10-08 08:51:17 +00:00
## Adding the Plugin to your project
Through the [Command-line Interface](http://cordova.apache.org/docs/en/3.0.0/guide_cli_index.md.html#The%20Command-line%20Interface):
```
cordova plugin add https://github.com/katzer/cordova-plugin-background-mode.git
```
## Removing the Plugin from your project
Through the [Command-line Interface](http://cordova.apache.org/docs/en/3.0.0/guide_cli_index.md.html#The%20Command-line%20Interface):
```
cordova plugin rm de.appplant.cordova.plugin.background-mode
```
## Release Notes
2013-10-09 12:54:23 +00:00
#### Version 0.2.1 (09.10.2013)
2013-10-09 12:16:00 +00:00
- Added js interface to manually enable/disable the background mode.
2013-10-08 14:41:24 +00:00
#### Version 0.2.0 (08.10.2013)
2013-10-08 14:39:40 +00:00
- Added iOS (>= 5) support<br>
2013-10-08 14:32:51 +00:00
The plugin turns the app into an location tracking app for the time it runs in the background.
2013-10-08 08:51:17 +00:00
## Using the plugin
2013-10-09 12:54:23 +00:00
Simply add the plugin to your project and the app will run while in background.
2013-10-09 12:16:00 +00:00
The plugin creates the object ```window.plugin.notification.backgroundMode``` with two methods:
### enable()
The method enables the background mode. The mode is activated once the app has entered the background and will be deactivated after the app has entered the foreground.<br>
Please be aware, to activate the background mode the app needs to be in foreground.
2013-10-08 14:32:10 +00:00
2013-10-08 14:39:40 +00:00
**iOS 5-6**<br>
The app still runs in background, even if the location service is not active.
**iOS 7**<br>
The location service needs to be enabled.
2013-10-09 12:16:00 +00:00
```javascript
/**
* Enables the background mode. The app will not pause while in background.
*/
window.plugin.backgroundMode.enable();
```
### disable()
The method disables the background mode. If the mode is disabled while the app is running in the background, the app will be paused immediately.
```javascript
/**
* Disables the background mode. The app will pause in background as usual.
*/
window.plugin.backgroundMode.disable();
```
2013-10-08 14:32:10 +00:00
## Quirks
### The app crashes under iOS
If the app crashes after installing the plugin, make sure that your `*-Info.plist` is valid.
Do to some bugs in cordova or Plugman please reset all occurences like
```xml
<key>NSMainNibFile</key>
<string>
</string>
```
2013-10-09 12:16:00 +00:00
to
2013-10-08 14:32:10 +00:00
```xml
<key>NSMainNibFile</key>
<string></string>
```