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:
  • Attempts to read a UUID from window.localStorage
  • If the value is missing or invalid, it tries to generate one based on browser fingerprint
  • If fingerprinting fails, generates a new UUID using Dart code (generateUUID)
  • The newly generated UUID is stored in localStorage for future reuse
  • Ensures the same UUID persists across reloads and sessions

🚀 Getting Started #

Add the dependency to your pubspec.yaml:

dependencies:
  unique_device_identifier: ^2.0.4

✅ Usage #

import 'package:unique_device_identifier/unique_device_identifier.dart';

void main() async {
  final String? deviceId = await UniqueDeviceIdentifier.getUniqueIdentifier();
  print("Device ID: $deviceId");
}

📦 Supported Platforms #

🔒 Notes #

• On iOS and Android, the UUID may change after uninstalling and reinstalling the app.
• macOS implementation avoids deprecated APIs on macOS 12+.
• On Web, the UUID is first read from localStorage. If it is missing or invalid, the plugin attempts to generate one using a browser fingerprint. If that fails, it falls back to a randomly generated UUID using Dart code. The final UUID is then stored in localStorage for future reuse and can be manually cleared by the user through the browser's storage settings.

🛠 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