📱 persistent_device_id #

A Flutter plugin that provides a unique, persistent, and secure device identifier—even after reinstalling the app or resetting the device. Supports Android and iOS using system-level cryptography and secure storage.

✨ Features #

• 🔒 Generates a unique and persistent ID per device
• ♻️ Persists across app reinstalls, cache wipes, and even factory resets (when possible)
• 🛡️ Uses MediaDrm, Android Keystore, and EncryptedSharedPreferences on Android
• 🍏 Uses Keychain on iOS
• 🚫 Requires no runtime permissions
• 📦 Simple, asynchronous API

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  persistent_device_id: <latest_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 #

This plugin uses different secure layers per platform to persist a device-unique identifier:

Android #

1. Attempts to derive a hardware-based ID from MediaDrm (API ≥ 18).

2. If MediaDrm is not supported or fails (e.g. on rooted/custom ROM devices), falls back to:

   • A generated UUID
   • Stored in EncryptedSharedPreferences
   • Protected by the Android Keystore

iOS #

• Uses the Keychain to securely store and persist a generated UUID.

✅ Android Requirements #

• minSdkVersion: 21
• compileSdkVersion: 34
• No special permissions needed

🚧 Limitations #

• MediaDrm only available on Android API ≥ 18
• On some custom or rooted ROMs, MediaDrm may be unreliable
• Factory reset will remove the ID unless hardware-backed
• On iOS, Keychain-based ID may reset if iCloud Keychain is disabled or device is restored without backup

🔍 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