> For the complete documentation index, see [llms.txt](https://danielsogl.gitbook.io/awesome-cordova-plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/plugins/foreground-service.md).

# Foreground Service

This plugin allows for android devices to continue running services in the background, using a foreground ongoing notification. This is targeted towards use with plugins such as 'cordova-geolocation' that will not run while the app is in the background on android API 26+.

For android API 28+, the following xml snippet should be inserted into `config.xml`:

```
...
<platform name="android">
  <config-file parent="/*" target="AndroidManifest.xml">
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  </config-file>
  ...
```

## Installation

```bash
ionic cordova plugin add cordova-plugin-foreground-service
npm install @awesome-cordova-plugins/foreground-service
```

**Plugin Repo:** <https://github.com/DavidBriglio/cordova-plugin-foreground-service>

## Supported Platforms

* Android

## Further Information

* [Installation Guide](/awesome-cordova-plugins/installation.md)
* [FAQ](/awesome-cordova-plugins/faq.md)