📱 persistent_device_id #

A Flutter plugin that provides a unique, persistent, and secure device identifier on Android—even after uninstalling and reinstalling the app.

✨ Features #

• 🔒 Generates a unique ID per device
• ♻️ Persists across app reinstalls (on Android API ≥ 18 with MediaDrm)
• 🧱 Securely stored using Android Keystore + EncryptedSharedPreferences
• 🚫 No runtime permissions required
• 📦 Simple, asynchronous API

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  persistent_device_id: <version>

Then run:

flutter pub get

🛠️ Usage #

Import the package #

import 'package:persistent_device_id/persistent_device_id.dart';

Get the device ID #

final deviceId = await PersistentDeviceId.getDeviceId();
print("Device ID: $deviceId");

⚙️ Supported Platforms #

🧠 How It Works #

1. On Android (API ≥ 18), the plugin attempts to use MediaDrm to derive a hardware-based identifier.

2. If MediaDrm is unavailable or fails (e.g. on rooted devices), a fallback UUID is generated once and securely stored using:

   • EncryptedSharedPreferences
   • Android Keystore

✅ Android Requirements #

• minSdkVersion: 21
• compileSdkVersion: 34
• No permissions required

🚧 Limitations #

• MediaDrm is only available on Android API 18 (Jelly Bean 4.3) and above.
• On some rooted or modified devices, MediaDrm may fail or behave inconsistently.
• iOS support is currently not available.

🔍 Example #

Clone the repository and run the example app:

cd example
flutter run

📄 License #

MIT License. © 2025 Mael Toukap.

🙋‍♂️ Contributing #

Contributions are welcome! Please open an issue or submit a pull request on GitHub.