📱 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

Platform	Support
Android	✅ Yes
iOS	✅ Yes

---

🧠 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