dave/cordova-plugin-run-in-background
1
0
Fork 0
forked from Github/cordova-plugin-run-in-background
Code Issues Pull Requests Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Sebastián Katzer 2013-12-01 13:49:36 +01:00
parent 0389bd53c3
commit d6f52306ab
1 changed files with 22 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
README.md
View File

@ -58,33 +58,20 @@ The method disables the background mode. If the mode is disabled while the app i
window.plugin.backgroundMode.disable(); window.plugin.backgroundMode.disable();
``` ```
## Quirks ## Platform specifics
### The app crashes under iOS ### Location tracking on 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>
```
to
```xml
<key>NSMainNibFile</key>
<string></string>
```
### Location tracking under iOS
**iOS 5-6**<br> **iOS 5-6**<br>
The app still runs in background, even if the location service is not actived. The app still runs in background, even if the location service is not actived.
**iOS 7**<br> **iOS 7**<br>
The location service needs to be enabled. The location service needs to be enabled.
### Optimization under WP8 ### Optimization on WP8
By default the plugin will track for geo updates while the application is in background and foreground. To stop tracking in foreground, the `MainPage.xaml.cs` file needs the following 2 methods: By default the plugin will track for geo updates while the application is in background and foreground. To stop tracking in foreground, the `MainPage.xaml.cs` file needs the following 2 methods:
```c# ```c#
// MainPage.xaml.cs
namespace your.own.namespace namespace your.own.namespace
{ {
public partial class MainPage : PhoneApplicationPage public partial class MainPage : PhoneApplicationPage
@ -110,6 +97,23 @@ namespace your.own.namespace
} }
``` ```
## Quirks
### The app crashes on 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>
```
to
```xml
<key>NSMainNibFile</key>
<string></string>
```
### TypeError: Cannot read property 'currentVersion' of null ### TypeError: Cannot read property 'currentVersion' of null
Along with Cordova 3.2 and Windows Phone 8 the `version.bat` script has to be renamed to `version`. Along with Cordova 3.2 and Windows Phone 8 the `version.bat` script has to be renamed to `version`.