background_permission_checker 1.0.1

A plugin to check auto-start permission and open settings

background_permission_checker

🚀 A Flutter plugin to check Auto-Start permission and open vendor-specific Auto-Start settings on Android devices.

📌 Overview

Android manufacturers like Xiaomi, Oppo, Vivo, Realme, Huawei, and Samsung often block apps from running background tasks unless Auto-Start is enabled. This plugin allows you to: Detect if Auto-Start is enabled Open the correct Auto-Start settings screen depending on the device brand Improve reliability for apps requiring background services (GPS, notifications, VoIP, chat, delivery apps, etc.)

✨ Features

✔ Check Auto-Start permission status 🔧 Open Auto-Start settings automatically

📱 Supports:

Xiaomi (MIUI) Oppo (ColorOS) Vivo (Funtouch OS) Realme Huawei (EMUI) Samsung Others (fallback to App Settings)

⚡ Works with Android 6+

🪶 Lightweight & no external dependencies

📦 Installation

Add to your pubspec.yaml:

dependencies:
background_permission_checker: ^0.0.1

Install:

flutter pub get

Import:

import 'package:background_permission_checker/background_permission_checker.dart';

🚀 Quick Usage ✔ Check Auto-Start Permission

final bool isEnabled = await BackgroundChecker.isAutoStartEnabled();
print("Auto-start status: $isEnabled");

✔ Open Auto-Start Settings

await BackgroundChecker.openAutoStartSettings();

📱 OEM Behavior Table Brand Opens Notes Xiaomi Auto-Start Management MIUI restricts background apps heavily Oppo App Permission Manager ColorOS has strict autostart control Vivo Background Startup Manager Funtouch OS restrictions Huawei Protected Apps Shows persistent protection options Realme Auto Launch Same as ColorOS Samsung App Info → Battery Limited auto-start APIs Others App Settings Fallback screen 🔧 Dart API Reference

1. isAutoStartEnabled()

Returns true if Auto-Start permission is enabled.

bool enabled = await BackgroundChecker.isAutoStartEnabled();

2. openAutoStartSettings()

Opens OEM-specific Auto-Start settings.

await BackgroundChecker.openAutoStartSettings();

📝 Example

import 'package:flutter/material.dart';
import 'package:background_permission_checker/background_permission_checker.dart';

class AutoStartDemo extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text("Auto-Start Checker")),
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
ElevatedButton(
onPressed: () async {
bool enabled = await BackgroundChecker.isAutoStartEnabled();
print("Auto-start: $enabled");
},
child: Text("Check Auto-Start"),
),
ElevatedButton(
onPressed: () async {
await BackgroundChecker.openAutoStartSettings();
},
child: Text("Open Auto-Start Settings"),
),
],
),
),
);
}
}

🧠 Why Use This Plugin?

Many apps depend on background tasks:

Delivery tracking Ride-sharing Messaging VoIP calling GPS/location OTP listeners

Health/fitness trackers

Most Android phones block these apps unless Auto-Start is enabled. This plugin solves that problem.

🛠️ Roadmap

Battery Optimization Detector Background Data Restriction Check Vendor Detection API Deep Link to Battery Settings Example app with UI

🤝 Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

⭐ Support the Project

Example App

Check out the example directory for a complete working app.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

If you find this package helpful, please give it a ⭐ on GitHub! EOF