Skip to main content

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>  ...

Stuck on a Cordova issue?

Don't waste precious time on plugin issues.

If you're building a serious project, you can't afford to spend hours troubleshooting. Ionic’s experts offer premium advisory services for both community plugins and premier plugins.


$ npm install cordova-plugin-foreground-service $ npm install @ionic-native/foreground-service $ ionic cap sync

Supported Platforms#

  • Android



Learn more about using Ionic Native components in React


import { ForegroundService } from '@ionic-native/foreground-service/ngx';

constructor(public foregroundService: ForegroundService) { }
startService() { // Notification importance is optional, the default is 1 - Low (no sound or vibration) this.foregroundService.start('GPS Running', 'Background Service', 'drawable/fsicon');}
stopService() { // Disable the foreground service this.foregroundService.stop();}