device_uid #

A Flutter plugin to retrieve device identifiers for advertising and analytics.

Features #

• Get a device-specific ID (ANDROID_ID on Android, identifierForVendor on iOS).
• Get the Advertising ID on both Android and iOS.
• Generate a random UUID.
• Null-safe and robust error handling.

Installation #

Add this to your pubspec.yaml:

dependencies:
  device_uid: ^2.0.0 # Use the latest version

Then run flutter pub get.

Usage #

Here's how to use the different methods provided by the package:

import 'package:device_uid/device_uid.dart';
import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // Get the device-specific ID
  String? deviceId = await DeviceUid.getDeviceId();
  print('Device ID: $deviceId');

  // Get the Advertising ID
  String? adId = await DeviceUid.getAdId();
  print('Advertising ID: $adId');

  // Generate a random UUID
  String? uuid = await DeviceUid.getUUID();
  print('Generated UUID: $uuid');
}

Platform-Specific Configuration #

Android #

For apps targeting Android 13 (API 33) or higher, you must declare the AD_ID permission in your AndroidManifest.xml to access the Advertising ID. This plugin already includes this permission in its manifest, so it will be merged into your app's manifest automatically.

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

iOS #

For apps running on iOS 14 or higher, you must request user permission to track their activity to get the Advertising ID. You can use a package like app_tracking_transparency to request this permission before calling getAdId().

You also need to add the NSUserTrackingUsageDescription key to your Info.plist file:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

ID Types Explained #

☕ Buy Me a Coffee #

If you find this package useful, consider supporting me:

• Donate USDT (TRC 20): TLbwVrZyaZujcTCXAb94t6k7BrvChVfxzi

Thank you for your support! ❤️