Expo Ignore Battery Optimizations

Check and request the REQUEST_IGNORE_BATTERY_OPTIMIZATIONS permission in Android.

Table of Contents

• Installation
• Configure for Android
• Usage
• Why Use This
• Contributing

Installation

npm install expo-ignore-battery-optimizations
pnpm install expo-ignore-battery-optimizations
yarn add expo-ignore-battery-optimizations

Configure for Android

plugin

// app.json
{
  "expo": {
    "plugins": ["expo-ignore-battery-optimizations"]
  }
}

manual permissions

// app.json
{
  "expo": {
    "android": {
      "permissions": ["REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"]
    },
  }
}

Usage

import { useEffect } from 'react';
import { View, Alert } from 'react-native';
import * as IgnoreBatteryOptimizations from 'expo-ignore-battery-optimizations';

export default function App() {
  useEffect(() => {
    const isIgnoring = IgnoreBatteryOptimizations.isIgnoringBatteryOptimizations();

    if (!isIgnoring) {
      Alert.alert(
        'Battery Optimization',
        'To ensure the app works properly, please allow it to ignore battery optimizations.',
        [
          {
            text: 'Cancel',
            style: 'cancel',
          },
          {
            text: 'Allow',
            onPress: () => {
              IgnoreBatteryOptimizations.requestIgnoreBatteryOptimizations();
            },
          },
        ],
      );
    }
  }, []);

  return <View />;
}

Why Use This?

Some Android device manufacturers aggressively limit background activity to save battery. To improve reliability of background services (e.g., location tracking, push messaging, etc.), your app may request the REQUEST_IGNORE_BATTERY_OPTIMIZATIONS permission.

⚠️ Note: Requesting this permission does not guarantee users will approve it, and it requires clear justification to avoid Play Store policy violations.

This intent is available only on Android 6.0 (API level 23) and above.

Contributing

Pull requests are welcome! If you’d like to fix a bug or propose a feature, feel free to open an issue or PR.