---
description: Capacitor plugin for Android to manage battery optimization settings, request exemptions, and enhance app performance under Doze and App Standby modes.
title: Capacitor Android Battery Optimization Plugin for Android - Capawesome
image: https://capawesome.io/docs/assets/images/social/sdks/capacitor/android-battery-optimization.png
---
[Skip to content ](#capacitor-android-battery-optimization-plugin)
[π₯οΈ Introducing the **Capacitor Electron Platform** β build desktop apps for macOS, Windows, and Linux. Free & open source. ](/blog/announcing-the-capacitor-electron-platform/)
* [ SDKs ](/docs/sdks/)
* [ Configuration ](#configuration)
* [ Demo ](#demo)
* [ Usage ](#usage)
* [ API ](#api)
* [ FAQ ](#faq)
* [ Related Plugins ](#related-plugins)
* [ Newsletter ](#newsletter)
* [ Changelog ](#changelog)
* [ License ](#license)
* [ Android Dark Mode Support ](/docs/sdks/capacitor/android-dark-mode-support/)
* [ Android Edge-to-Edge Support ](/docs/sdks/capacitor/android-edge-to-edge-support/)
* [ Android Foreground Service ](/docs/sdks/capacitor/android-foreground-service/)
* [ Android Intent Launcher ](/docs/sdks/capacitor/android-intent-launcher/)
* [ Android SMS Retriever ](/docs/sdks/capacitor/android-sms-retriever/)
* [ App Icon ](/docs/sdks/capacitor/app-icon/)
* [ App Integrity ](/docs/sdks/capacitor/app-integrity/)
* [ App Language ](/docs/sdks/capacitor/app-language/)
* [ App Launcher ](/docs/sdks/capacitor/app-launcher/)
* [ App Review ](/docs/sdks/capacitor/app-review/)
* [ App Shortcuts ](/docs/sdks/capacitor/app-shortcuts/)
* [ App Tracking Transparency ](/docs/sdks/capacitor/app-tracking-transparency/)
* [ App Update ](/docs/sdks/capacitor/app-update/)
* [ Apple Sign-In ](/docs/sdks/capacitor/apple-sign-in/)
* [ Asset Manager ](/docs/sdks/capacitor/asset-manager/)
* [ Audio Player ](/docs/sdks/capacitor/audio-player/)
* [ Audio Recorder ](/docs/sdks/capacitor/audio-recorder/)
* [ Audio Session ](/docs/sdks/capacitor/audio-session/)
* [ Background Task ](/docs/sdks/capacitor/background-task/)
* [ Badge ](/docs/sdks/capacitor/badge/)
* [ Barometer ](/docs/sdks/capacitor/barometer/)
* [ Battery ](/docs/sdks/capacitor/battery/)
* [ Biometrics ](/docs/sdks/capacitor/biometrics/)
* [ Bluetooth Low Energy ](/docs/sdks/capacitor/bluetooth-low-energy/)
* [ Clipboard ](/docs/sdks/capacitor/clipboard/)
* [ Cloudinary ](/docs/sdks/capacitor/cloudinary/)
* [ Compass ](/docs/sdks/capacitor/compass/)
* [ Contacts ](/docs/sdks/capacitor/contacts/)
* [ Crisp ](/docs/sdks/capacitor/crisp/)
* [ Datetime Picker ](/docs/sdks/capacitor/datetime-picker/)
* [ Device Info ](/docs/sdks/capacitor/device-info/)
* [ Dialog ](/docs/sdks/capacitor/dialog/)
* [ Electron ](/docs/sdks/capacitor/electron/)
* [ Exif ](/docs/sdks/capacitor/exif/)
* [ Facebook Sign-In ](/docs/sdks/capacitor/facebook-sign-in/)
* [ File Compressor ](/docs/sdks/capacitor/file-compressor/)
* [ File Opener ](/docs/sdks/capacitor/file-opener/)
* [ File Picker ](/docs/sdks/capacitor/file-picker/)
* [ Firebase ](/docs/sdks/capacitor/firebase/)
* [ Formbricks ](/docs/sdks/capacitor/formbricks/)
* [ Geocoder ](/docs/sdks/capacitor/geocoder/)
* [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/)
* [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/)
* [ Gyroscope ](/docs/sdks/capacitor/gyroscope/)
* [ Haptics ](/docs/sdks/capacitor/haptics/)
* [ Home Indicator ](/docs/sdks/capacitor/home-indicator/)
* [ In-App Browser ](/docs/sdks/capacitor/in-app-browser/)
* [ Install Referrer ](/docs/sdks/capacitor/install-referrer/)
* [ Intercom ](/docs/sdks/capacitor/intercom/)
* [ Intune ](/docs/sdks/capacitor/intune/)
* [ Keep Awake ](/docs/sdks/capacitor/keep-awake/)
* [ libSQL ](/docs/sdks/capacitor/libsql/)
* [ Light Sensor ](/docs/sdks/capacitor/light-sensor/)
* [ Live Update ](/docs/sdks/capacitor/live-update/)
* [ Localization ](/docs/sdks/capacitor/localization/)
* [ Mail Composer ](/docs/sdks/capacitor/mail-composer/)
* [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/)
* [ Maps Launcher ](/docs/sdks/capacitor/maps-launcher/)
* [ Media Session ](/docs/sdks/capacitor/media-session/)
* [ ML Kit ](/docs/sdks/capacitor/mlkit/)
* [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/)
* [ Network ](/docs/sdks/capacitor/network/)
* [ NFC ](/docs/sdks/capacitor/nfc/)
* [ Node.js ](/docs/sdks/capacitor/nodejs/)
* [ OAuth ](/docs/sdks/capacitor/oauth/)
* [ Passkeys ](/docs/sdks/capacitor/passkeys/)
* [ Password Autofill ](/docs/sdks/capacitor/password-autofill/)
* [ PDF Generator ](/docs/sdks/capacitor/pdf-generator/)
* [ PDF Viewer ](/docs/sdks/capacitor/pdf-viewer/)
* [ Pedometer ](/docs/sdks/capacitor/pedometer/)
* [ Permissions ](/docs/sdks/capacitor/permissions/)
* [ Phone Dialer ](/docs/sdks/capacitor/phone-dialer/)
* [ Photo Editor ](/docs/sdks/capacitor/photo-editor/)
* [ Photo Manipulator ](/docs/sdks/capacitor/photo-manipulator/)
* [ PixLive ](/docs/sdks/capacitor/pixlive/)
* [ PostHog ](/docs/sdks/capacitor/posthog/)
* [ Printer ](/docs/sdks/capacitor/printer/)
* [ Privacy Screen ](/docs/sdks/capacitor/privacy-screen/)
* [ Proximity Sensor ](/docs/sdks/capacitor/proximity-sensor/)
* [ Purchases ](/docs/sdks/capacitor/purchases/)
* [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/)
* [ Root Detection ](/docs/sdks/capacitor/root-detection/)
* [ Screen Brightness ](/docs/sdks/capacitor/screen-brightness/)
* [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/)
* [ Screen Reader ](/docs/sdks/capacitor/screen-reader/)
* [ Screenshot ](/docs/sdks/capacitor/screenshot/)
* [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/)
* [ Settings Launcher ](/docs/sdks/capacitor/settings-launcher/)
* [ Shake ](/docs/sdks/capacitor/shake/)
* [ Silent Mode ](/docs/sdks/capacitor/silent-mode/)
* [ SIM ](/docs/sdks/capacitor/sim/)
* [ SMS Composer ](/docs/sdks/capacitor/sms-composer/)
* [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/)
* [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/)
* [ Share Target ](/docs/sdks/capacitor/share-target/)
* [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/)
* [ SQLite ](/docs/sdks/capacitor/sqlite/)
* [ Superwall ](/docs/sdks/capacitor/superwall/)
* [ System WebView ](/docs/sdks/capacitor/system-webview/)
* [ Tauri ](/docs/sdks/capacitor/tauri/)
* [ Text Interaction ](/docs/sdks/capacitor/text-interaction/)
* [ Text Zoom ](/docs/sdks/capacitor/text-zoom/)
* [ Thermal State ](/docs/sdks/capacitor/thermal-state/)
* [ Toast ](/docs/sdks/capacitor/toast/)
* [ Torch ](/docs/sdks/capacitor/torch/)
* [ Vault ](/docs/sdks/capacitor/vault/)
* [ Volume ](/docs/sdks/capacitor/volume/)
* [ Wallet ](/docs/sdks/capacitor/wallet/)
* [ Wifi ](/docs/sdks/capacitor/wifi/)
* [ YouTube Player ](/docs/sdks/capacitor/youtube-player/)
* [ Zip ](/docs/sdks/capacitor/zip/)
* [ Cordova ](/docs/sdks/cordova/)
* [ Cloud ](/docs/cloud/)
* [ Integrations ](/docs/cloud/live-updates/integrations/)
* Concepts
* Reference
* [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/)
* [ FAQ ](/docs/cloud/live-updates/faq/)
* [ Native Builds ](/docs/cloud/native-builds/)
* [ Set Up Environments ](/docs/cloud/native-builds/environments/)
* [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/)
* [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/)
* [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/)
* [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/)
* [ Use pnpm, Yarn, or bun ](/docs/cloud/native-builds/package-managers/)
* [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/)
* [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/)
* [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/)
* [ Build without Git ](/docs/cloud/native-builds/build-without-git/)
* [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/)
* [ Integrations ](/docs/cloud/native-builds/integrations/)
* Reference
* [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/)
* [ FAQ ](/docs/cloud/native-builds/faq/)
* [ App Store Publishing ](/docs/cloud/app-store-publishing/)
* [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/)
* [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/)
* [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/)
* [ FAQ ](/docs/cloud/app-store-publishing/faq/)
* [ Automations ](/docs/cloud/automations/)
* [ Reference ](/docs/cloud/automations/reference/)
* [ Troubleshooting ](/docs/cloud/automations/troubleshooting/)
* [ FAQ ](/docs/cloud/automations/faq/)
* [ Assist ](/docs/cloud/assist/)
* [ CLI ](/docs/cloud/cli/)
* APIs and SDKs
* [ Webhooks ](/docs/cloud/webhooks/)
* [ Integrations ](/docs/cloud/integrations/)
* Account
* [ Organization ](/docs/cloud/organizations/)
* [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/)
* [ Audit Logs ](/docs/cloud/organizations/audit-logs/)
* [ Billing ](/docs/cloud/organizations/billing/)
* [ License Keys ](/docs/cloud/license-keys/)
* [ AI ](/docs/ai/)
* [ Insiders ](/docs/insiders/)
* [ Billing & Plans ](/docs/insiders/billing-and-plans/)
* [ FAQ ](/docs/insiders/faq/)
* [ License ](https://capawesome.io/legal/eula/)
* [ Support ](/docs/support/)
* [ Contributing ](/docs/contributing/)
* Contributing code
* [ Code of Conduct ](/docs/contributing/code-of-conduct/)
* [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion)
* [ Blog ](/blog/)
* Categories
* [ Configuration ](#configuration)
* [ Demo ](#demo)
* [ Usage ](#usage)
* [ API ](#api)
* [ FAQ ](#faq)
* [ Related Plugins ](#related-plugins)
* [ Newsletter ](#newsletter)
* [ Changelog ](#changelog)
* [ License ](#license)
# Capacitor Android Battery Optimization Plugin[ΒΆ](#capacitor-android-battery-optimization-plugin "Permanent link")
Capacitor plugin for Android to manage battery optimization settings, request exemptions, and enhance app performance under Doze and App Standby modes.
[  ](https://cloud.capawesome.io/)
## Use Cases[ΒΆ](#use-cases "Permanent link")
The Android Battery Optimization plugin is typically used by apps whose core function is affected by Doze and App Standby, for example:
* **Background reliability checks**: Detect whether battery optimization is enabled and inform the user that background work may be deferred.
* **Guided settings flow**: Open the battery optimization settings page so the user can manually exclude your app from battery optimization.
* **Direct exemption requests**: Request the battery optimization ignore permission when the core function of your app is adversely affected by Power Management features.
* **Troubleshooting support**: Help users understand why they receive delayed updates from your app by checking the battery optimization status.
## Compatibility[ΒΆ](#compatibility "Permanent link")
| Plugin Version | Capacitor Version | Status |
| -------------- | ----------------- | -------------- |
| 8.x.x | \>=8.x.x | Active support |
## Installation[ΒΆ](#installation "Permanent link")
You can use our **AI-Assisted Setup** to install the plugin. Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
`[](#%5F%5Fcodelineno-0-1)npx skills add capawesome-team/skills --skill capacitor-plugins
`
Then use the following prompt:
`` [](#%5F%5Fcodelineno-1-1)Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome-team/capacitor-android-battery-optimization` plugin in my project.
``
If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
`[](#%5F%5Fcodelineno-2-1)npm install @capawesome-team/capacitor-android-battery-optimization
[](#%5F%5Fcodelineno-2-2)npx cap sync
`
### Android[ΒΆ](#android "Permanent link")
This API requires the following permissions be added to your `AndroidManifest.xml` before the `application` tag if you want to request direct exemption from Power Management features:
`[](#%5F%5Fcodelineno-3-1)
`
β οΈ **Attention**: Google Play policies prohibit apps from requesting direct exemption from Power Management features in Android 6.0+ (Doze and App Standby) unless the core function of the app is adversely affected. [Source](https://developer.android.com/training/monitoring-device-state/doze-standby.html#support%5Ffor%5Fother%5Fuse%5Fcases)
## Configuration[ΒΆ](#configuration "Permanent link")
No configuration required for this plugin.
## Demo[ΒΆ](#demo "Permanent link")
A working example can be found here: [robingenz/capacitor-plugin-demo](https://github.com/robingenz/capacitor-plugin-demo)
| Android |
| --------------------------------------------------------------------------------------------------------------------------------------- |
|  |
## Usage[ΒΆ](#usage "Permanent link")
The following examples show how to check whether battery optimization is enabled, open the battery optimization settings, and request an exemption from battery optimization.
### Check if battery optimization is enabled[ΒΆ](#check-if-battery-optimization-is-enabled "Permanent link")
Find out whether battery optimization is enabled for the device, for example to inform the user that background work may be deferred. All methods of this plugin are only available on Android, so guard your calls with a platform check:
`[](#%5F%5Fcodelineno-4-1)import { BatteryOptimization } from '@capawesome-team/capacitor-android-battery-optimization';
[](#%5F%5Fcodelineno-4-2)import { Capacitor } from '@capacitor/core';
[](#%5F%5Fcodelineno-4-3)
[](#%5F%5Fcodelineno-4-4)const isBatteryOptimizationEnabled = async () => {
[](#%5F%5Fcodelineno-4-5) if (Capacitor.getPlatform() !== 'android') {
[](#%5F%5Fcodelineno-4-6) return false;
[](#%5F%5Fcodelineno-4-7) }
[](#%5F%5Fcodelineno-4-8) const { enabled } = await BatteryOptimization.isBatteryOptimizationEnabled();
[](#%5F%5Fcodelineno-4-9) return enabled;
[](#%5F%5Fcodelineno-4-10)};
`
### Open the battery optimization settings[ΒΆ](#open-the-battery-optimization-settings "Permanent link")
Open the battery optimization settings page so the user can manually exclude your app from battery optimization:
`[](#%5F%5Fcodelineno-5-1)import { BatteryOptimization } from '@capawesome-team/capacitor-android-battery-optimization';
[](#%5F%5Fcodelineno-5-2)import { Capacitor } from '@capacitor/core';
[](#%5F%5Fcodelineno-5-3)
[](#%5F%5Fcodelineno-5-4)const openBatteryOptimizationSettings = async () => {
[](#%5F%5Fcodelineno-5-5) if (Capacitor.getPlatform() !== 'android') {
[](#%5F%5Fcodelineno-5-6) return;
[](#%5F%5Fcodelineno-5-7) }
[](#%5F%5Fcodelineno-5-8) await BatteryOptimization.openBatteryOptimizationSettings();
[](#%5F%5Fcodelineno-5-9)};
`
### Request an exemption from battery optimization[ΒΆ](#request-an-exemption-from-battery-optimization "Permanent link")
Request the battery optimization ignore permission directly. This method requires the `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` manifest permission (see [Installation](#installation)) and should only be used if your app meets an acceptable use case according to the Google Play policy:
`[](#%5F%5Fcodelineno-6-1)import { BatteryOptimization } from '@capawesome-team/capacitor-android-battery-optimization';
[](#%5F%5Fcodelineno-6-2)import { Capacitor } from '@capacitor/core';
[](#%5F%5Fcodelineno-6-3)
[](#%5F%5Fcodelineno-6-4)const requestIgnoreBatteryOptimization = async () => {
[](#%5F%5Fcodelineno-6-5) if (Capacitor.getPlatform() !== 'android') {
[](#%5F%5Fcodelineno-6-6) return;
[](#%5F%5Fcodelineno-6-7) }
[](#%5F%5Fcodelineno-6-8) await BatteryOptimization.requestIgnoreBatteryOptimization();
[](#%5F%5Fcodelineno-6-9)};
`
## API[ΒΆ](#api "Permanent link")
* [isBatteryOptimizationEnabled()](#isbatteryoptimizationenabled)
* [openBatteryOptimizationSettings()](#openbatteryoptimizationsettings)
* [requestIgnoreBatteryOptimization()](#requestignorebatteryoptimization)
* [Interfaces](#interfaces)
### isBatteryOptimizationEnabled()[ΒΆ](#isbatteryoptimizationenabled "Permanent link")
`[](#%5F%5Fcodelineno-7-1)isBatteryOptimizationEnabled() => Promise
`
Returns whether or not battery optimization is enabled.
Only available on Android.
**Returns:** `Promise<[IsBatteryOptimizationEnabledResult](#isbatteryoptimizationenabledresult)>`
**Since:** 0.0.1
---
### openBatteryOptimizationSettings()[ΒΆ](#openbatteryoptimizationsettings "Permanent link")
`[](#%5F%5Fcodelineno-8-1)openBatteryOptimizationSettings() => Promise
`
Opens the battery optimization settings page.
Only available on Android.
**Since:** 0.0.1
---
### requestIgnoreBatteryOptimization()[ΒΆ](#requestignorebatteryoptimization "Permanent link")
`[](#%5F%5Fcodelineno-9-1)requestIgnoreBatteryOptimization() => Promise
`
Requests the battery optimization ignore permission. This method needs the `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` manifest permission. Use this method only if your app meets an acceptable use case (see Google Play Policy).
Only available on Android.
**Since:** 0.0.1
---
### Interfaces[ΒΆ](#interfaces "Permanent link")
#### IsBatteryOptimizationEnabledResult[ΒΆ](#isbatteryoptimizationenabledresult "Permanent link")
| Prop | Type | Description | Since |
| ----------- | ------- | ----------------------------------------------- | ----- |
| **enabled** | boolean | Whether or not battery optimization is enabled. | 0.0.1 |
## FAQ[ΒΆ](#faq "Permanent link")
### Does this plugin work on iOS or the Web?[ΒΆ](#does-this-plugin-work-on-ios-or-the-web "Permanent link")
No, all methods of this plugin are only available on Android, since battery optimization with Doze and App Standby is an Android concept. On other platforms, guard your calls with a platform check using `Capacitor.getPlatform()` as shown in the [usage examples](#usage).
### What is the difference between opening the settings and requesting an exemption?[ΒΆ](#what-is-the-difference-between-opening-the-settings-and-requesting-an-exemption "Permanent link")
The `openBatteryOptimizationSettings()` method opens the battery optimization settings page, where the user has to find and exclude your app manually. The `requestIgnoreBatteryOptimization()` method asks the user directly to exempt your app, but requires the `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` manifest permission and is subject to Google Play policy restrictions.
### Do I need to add any permissions to my app?[ΒΆ](#do-i-need-to-add-any-permissions-to-my-app "Permanent link")
Only if you want to use `requestIgnoreBatteryOptimization()`. In that case, add the `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` permission to your `AndroidManifest.xml` as described in the [Installation](#installation) section. Checking the battery optimization status and opening the settings page do not require any permissions.
### Can requesting an exemption get my app rejected from Google Play?[ΒΆ](#can-requesting-an-exemption-get-my-app-rejected-from-google-play "Permanent link")
Google Play policies prohibit apps from requesting direct exemption from Power Management features in Android 6.0+ (Doze and App Standby) unless the core function of the app is adversely affected. Use `requestIgnoreBatteryOptimization()` only if your app meets an acceptable use case, or open the battery optimization settings with `openBatteryOptimizationSettings()` instead. See the [Android documentation](https://developer.android.com/training/monitoring-device-state/doze-standby.html#support%5Ffor%5Fother%5Fuse%5Fcases) for more information.
### Why is background work in my app delayed on Android?[ΒΆ](#why-is-background-work-in-my-app-delayed-on-android "Permanent link")
When battery optimization is enabled, Android defers background work under Doze and App Standby, which can delay tasks your app performs in the background. You can use `isBatteryOptimizationEnabled()` to detect this and guide the user to exclude your app from battery optimization.
### Can I use this plugin with Ionic, React, Vue or Angular?[ΒΆ](#can-i-use-this-plugin-with-ionic-react-vue-or-angular "Permanent link")
Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects.
## Related Plugins[ΒΆ](#related-plugins "Permanent link")
* [Android Foreground Service](https://capawesome.io/docs/sdks/capacitor/android-foreground-service/): Run a foreground service on Android.
* [Background Task](https://capawesome.io/docs/sdks/capacitor/background-task/): Run background tasks in your app.
* [Battery](https://capawesome.io/docs/sdks/capacitor/battery/): Access battery information.
## Newsletter[ΒΆ](#newsletter "Permanent link")
Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
## Changelog[ΒΆ](#changelog "Permanent link")
See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/android-battery-optimization/CHANGELOG.md).
## License[ΒΆ](#license "Permanent link")
See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/android-battery-optimization/LICENSE).
July 8, 2026
Back to top
```json
{"@context": "https://schema.org", "@graph": [{"@type": "TechArticle", "@id": "https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/#article", "headline": "Capacitor Android Battery Optimization Plugin for Android", "name": "Capacitor Android Battery Optimization Plugin for Android", "description": "Capacitor plugin for Android to manage battery optimization settings, request exemptions, and enhance app performance under Doze and App Standby modes.", "inLanguage": "en", "url": "https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/", "mainEntityOfPage": "https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "about": {"@id": "https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/#software"}}, {"@type": "SoftwareSourceCode", "@id": "https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/#software", "name": "Capacitor Android Battery Optimization Plugin for Android", "description": "Capacitor plugin for Android to manage battery optimization settings, request exemptions, and enhance app performance under Doze and App Standby modes.", "url": "https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/", "programmingLanguage": "TypeScript", "runtimePlatform": "Capacitor", "codeRepository": "https://github.com/capawesome-team", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}}]}
{"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Does this plugin work on iOS or the Web?", "acceptedAnswer": {"@type": "Answer", "text": "No, all methods of this plugin are only available on Android, since battery optimization with Doze and App Standby is an Android concept. On other platforms, guard your calls with a platform check using Capacitor.getPlatform() as shown in the usage examples."}}, {"@type": "Question", "name": "What is the difference between opening the settings and requesting an exemption?", "acceptedAnswer": {"@type": "Answer", "text": "The openBatteryOptimizationSettings() method opens the battery optimization settings page, where the user has to find and exclude your app manually. The requestIgnoreBatteryOptimization() method asks the user directly to exempt your app, but requires the REQUEST_IGNORE_BATTERY_OPTIMIZATIONS manifest permission and is subject to Google Play policy restrictions."}}, {"@type": "Question", "name": "Do I need to add any permissions to my app?", "acceptedAnswer": {"@type": "Answer", "text": "Only if you want to use requestIgnoreBatteryOptimization(). In that case, add the REQUEST_IGNORE_BATTERY_OPTIMIZATIONS permission to your AndroidManifest.xml as described in the Installation section. Checking the battery optimization status and opening the settings page do not require any permissions."}}, {"@type": "Question", "name": "Can requesting an exemption get my app rejected from Google Play?", "acceptedAnswer": {"@type": "Answer", "text": "Google Play policies prohibit apps from requesting direct exemption from Power Management features in Android 6.0+ (Doze and App Standby) unless the core function of the app is adversely affected. Use requestIgnoreBatteryOptimization() only if your app meets an acceptable use case, or open the battery optimization settings with openBatteryOptimizationSettings() instead. See the Android documentation for more information."}}, {"@type": "Question", "name": "Why is background work in my app delayed on Android?", "acceptedAnswer": {"@type": "Answer", "text": "When battery optimization is enabled, Android defers background work under Doze and App Standby, which can delay tasks your app performs in the background. You can use isBatteryOptimizationEnabled() to detect this and guide the user to exclude your app from battery optimization."}}, {"@type": "Question", "name": "Can I use this plugin with Ionic, React, Vue or Angular?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects."}}], "url": "https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/"}
```