Flutter唯一标识符生成插件fcuuid_kit的使用

Flutter唯一标识符生成插件fcuuid_kit的使用

简介

fcuuid_kit 是一个用于在 Flutter 应用中生成唯一标识符的插件。它基于 iOS 平台上的 FCUUID 实现，并提供了多种生成 UUID 的方法。

使用步骤

1. 添加依赖

在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  fcuuid_kit: ^版本号

然后运行以下命令安装依赖：

flutter pub get

2. 初始化插件

在应用启动时初始化插件，例如在 main() 函数中调用 _uuid() 方法。

示例代码

以下是一个完整的示例代码，展示如何使用 fcuuid_kit 插件生成不同类型的唯一标识符。

import 'package:fcuuid_kit/fcuuid_kit.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({
    super.key,
  });

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    _uuid(); // 在初始化时生成 UUID
  }

  Future<void> _uuid() async {
    if (kDebugMode) {
      // 生成通用 UUID
      print('uuid: ${await Fcuuid.instance.uuid()}');

      // 根据指定键生成 UUID
      print('uuidForKey: ${await Fcuuid.instance.uuidForKey(key: 'abc')}');

      // 生成会话 UUID
      print('uuidForSession: ${await Fcuuid.instance.uuidForSession()}');

      // 生成安装 UUID
      print('uuidForInstallation: ${await Fcuuid.instance.uuidForInstallation()}');

      // 生成厂商 UUID
      print('uuidForVendor: ${await Fcuuid.instance.uuidForVendor()}');

      // 生成设备 UUID
      print('uuidForDevice: ${await Fcuuid.instance.uuidForDevice()}');

      // 迁移设备 UUID（示例）
      print(
        'uuidForDeviceMigratingValue: ${await Fcuuid.instance.uuidForDeviceMigratingValue(value: await Fcuuid.instance.uuid(), commitMigration: true)}',
      );

      // 再次生成设备 UUID
      print('uuidForDevice: ${await Fcuuid.instance.uuidForDevice()}');

      // 错误示例（会崩溃），未知正确用法
      // print('uuidForDeviceMigratingValueForKey: ${await Fcuuid.uuidForDeviceMigratingValueForKey(key: 'abc', commitMigration: true)}');

      // 再次生成设备 UUID
      // print('uuidForDevice: ${await Fcuuid.uuidForDevice()}');

      // 获取用户所有设备的 UUID 列表
      print('uuidsOfUserDevices: ${await Fcuuid.instance.uuidsOfUserDevices()}');

      // 获取用户所有设备的 UUID 列表（排除当前设备）
      print(
        'uuidsOfUserDevicesExcludingCurrentDevice: ${await Fcuuid.instance.uuidsOfUserDevicesExcludingCurrentDevice()}',
      );

      // 验证 UUID 是否有效
      print(
        'uuidValueIsValid: ${await Fcuuid.instance.uuidValueIsValid(uuid: await Fcuuid.instance.uuidForDevice())}',
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('FCUUID 示例'),
        ),
      ),
    );
  }
}

输出示例

运行上述代码后，控制台将打印出类似以下内容：

uuid: 8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ
uuidForKey: 8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ
uuidForSession: 8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ
uuidForInstallation: 8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ
uuidForVendor: 8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ
uuidForDevice: 8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ
uuidForDeviceMigratingValue: 8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ
uuidForDevice: 8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ
uuidsOfUserDevices: [8B9F3A4C-5D6E-7F8G-9H0I-JKLMNOPQRSTUVWXYZ, ...]
uuidsOfUserDevicesExcludingCurrentDevice: [...]
uuidValueIsValid: true