unique_device_identifier

A Flutter plugin that provides a unique device identifier on all platforms including Android, iOS, Windows, macOS, Linux, Web.

---

✨ Features

• 📱 Android: Uses Settings.Secure.ANDROID_ID
• 🍎 iOS: Uses UIDevice.identifierForVendor
• 💻 macOS: Uses IOPlatformUUID via IOKit
  • Automatically uses kIOMainPortDefault on macOS 12+ (no deprecation warning)
  • Falls back to kIOMasterPortDefault for compatibility with macOS 11 and earlier
• 🐧 Linux: Reads /etc/machine-id
• 🪟 Windows: Reads registry value MachineGuid
• 🌐 Web:
  • First attempts to read a stored UUID from localStorage
  • If not found, generates a fingerprint-based hash from browser characteristics
  • Falls back to a random UUID if fingerprinting fails
  • Stores the newly generated UUID in localStorage for future use

---

🚀 Getting Started

Add the dependency to your pubspec.yaml:

dependencies:
  unique_device_identifier: ^2.0.2

---

✅ Usage

import 'package:unique_device_identifier/unique_device_identifier.dart';

void main() async {
  final id = await UniqueDeviceIdentifier.getUniqueIdentifier();
  final safeId = await UniqueDeviceIdentifier.getSafeUniqueIdentifier();
  print("Raw: $id");
  print("Safe: $safeId");
}

---

📦 Supported Platforms

Platform	Method
Android	Settings.Secure.ANDROID_ID
iOS	UIDevice.identifierForVendor
macOS	IOPlatformUUID (via IOKit with macOS version fallback)
Linux	/etc/machine-id
Windows	Registry HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\MachineGuid
Web	Checks localStorage first, then generates fingerprint hash or random UUID

---

🔒 Notes

• On iOS and Android, the UUID may change after uninstalling and reinstalling the app.
• On Web, UUID is stored in localStorage and may be cleared manually by the user.
• macOS implementation avoids deprecated APIs on macOS 12+.
• No external packages (like uuid or device_info_plus) are used.

---

🛠 Development

This plugin uses MethodChannel to communicate with native code.

Each platform implements get_unique_identifier using platform-specific APIs, and the Web implementation is written in Dart using dart:js_interop.

---

📄 License

MIT License