Flutter ——device_info_plus详解

device_info_plus 是 Flutter 生态中最权威的设备信息获取库（官方维护），替代了已废弃的 device_info，支持 Android、iOS、Web、Windows、macOS、Linux、Android TV、watchOS 等几乎所有 Flutter 支持的平台。库地址 pub.dev/packages/de...

安装

在项目的 pubspec.yaml 中添加依赖：

yaml 复制代码

dependencies:
  flutter:
    sdk: flutter
    device_info_plus: ^12.3.0 # 建议使用最新版本

执行命令安装：

arduino 复制代码

flutter pub get

一、核心基础：包架构与初始化

1. 核心类与初始化

device_info_plus 的核心是 DeviceInfoPlugin 单例，通过它可以获取不同平台的设备信息对象：

Dart 复制代码

import 'package:device_info_plus/device_info_plus.dart';

// 1. 创建插件实例（全局唯一）
final DeviceInfoPlugin deviceInfoPlugin = DeviceInfoPlugin();

// 2. 初始化（非必需，但异步操作建议在WidgetsFlutterBinding初始化后执行）
void initDeviceInfo() async {
  WidgetsFlutterBinding.ensureInitialized(); // 无上下文时必须调用
  // 后续获取设备信息的操作...
}

2. 平台与信息类对应表

平台	信息获取方法	核心信息类	适用场景
Android	`await deviceInfoPlugin.androidInfo`	`AndroidDeviceInfo`	获取安卓设备型号、系统版本、厂商等
iOS	`await deviceInfoPlugin.iosInfo`	`IosDeviceInfo`	获取 iOS 版本、设备型号、UUID 等
Web	`await deviceInfoPlugin.webBrowserInfo`	`WebBrowserInfo`	获取浏览器、操作系统、用户代理等
Windows	`await deviceInfoPlugin.windowsInfo`	`WindowsDeviceInfo`	获取 Windows 系统版本、处理器、设备名等
macOS	`await deviceInfoPlugin.macOsInfo`	`MacOsDeviceInfo`	获取 Mac 系统版本、机型、内存等
Linux	`await deviceInfoPlugin.linuxInfo`	`LinuxDeviceInfo`	获取 Linux 发行版、内核版本等
Android TV	`await deviceInfoPlugin.androidTvInfo`	`AndroidTvDeviceInfo`	区分安卓电视 / 普通安卓设备
watchOS	`await deviceInfoPlugin.watchOsInfo`	`WatchOsDeviceInfo`	获取苹果手表信息
Wear OS	`await deviceInfoPlugin.wearOsInfo`	`WearOsDeviceInfo`	获取安卓手表信息
Fuchsia	`await deviceInfoPlugin.fuchsiaInfo`	`FuchsiaDeviceInfo`	适配 Fuchsia 系统（暂未普及）

二、全平台核心 API 详解

1. Android 平台（`AndroidDeviceInfo`）

最常用的属性（覆盖 90% 场景）：

Dart 复制代码

AndroidDeviceInfo androidInfo = await deviceInfoPlugin.androidInfo;
print('=== Android 设备信息 ===');
print('设备型号：${androidInfo.model}'); // 例：Pixel 8 Pro、Redmi K70
print('系统版本：${androidInfo.version.release}'); // 例：14、13
print('API等级：${androidInfo.version.sdkInt}'); // 例：34（Android 14）、33（Android 13）
print('厂商：${androidInfo.manufacturer}'); // 例：Google、Xiaomi、Huawei
print('品牌：${androidInfo.brand}'); // 例：google、xiaomi、huawei
print('设备ID：${androidInfo.id}'); // 设备唯一标识（Android 10+ 无权限获取）
print('产品名：${androidInfo.product}'); // 例：cheetah（Pixel 8 Pro）
print('是否真机：${androidInfo.isPhysicalDevice}'); // true=真机，false=模拟器
print('指纹：${androidInfo.fingerprint}'); // 系统指纹（用于版本判断）
print('硬件名称：${androidInfo.hardware}'); // 例：qcom（高通）
print('支持的ABIs：${androidInfo.supportedAbis}'); // 支持的CPU架构（armeabi-v7a、arm64-v8a等）

2. iOS 平台（`IosDeviceInfo`）

Dart 复制代码

IosDeviceInfo iosInfo = await deviceInfoPlugin.iosInfo;
print('=== iOS 设备信息 ===');
print('设备名称：${iosInfo.name}'); // 例：iPhone 15 Pro
print('系统版本：${iosInfo.systemVersion}'); // 例：17.2
print('设备型号：${iosInfo.model}'); // 例：iPhone
print('具体机型：${iosInfo.utsname.machine}'); // 例：iPhone16,1（对应iPhone 15 Pro）
print('是否真机：${iosInfo.isPhysicalDevice}'); // true=真机，false=模拟器
print('设备UUID：${iosInfo.identifierForVendor}'); // 应用厂商唯一标识（卸载重装会变）
print('系统名称：${iosInfo.systemName}'); // 例：iOS、iPadOS
print('电池电量：${iosInfo.batteryLevel}'); // 0.0-1.0（需权限）
print('是否充电：${iosInfo.isCharging}');

3. Web 平台（`WebBrowserInfo`）

Dart 复制代码

WebBrowserInfo webInfo = await deviceInfoPlugin.webBrowserInfo;
print('=== Web 浏览器信息 ===');
print('浏览器名称：${webInfo.browserName}'); // BrowserName.chrome/edge/firefox/safari等
print('浏览器版本：${webInfo.browserVersion}'); // 例：120.0.0.0
print('操作系统：${webInfo.platform}'); // 例：Windows、macOS、Android
print('用户代理：${webInfo.userAgent}'); // 完整UA字符串
print('语言：${webInfo.language}'); // 例：zh-CN
print('是否移动设备：${webInfo.isMobile}'); // true/false

4. Windows 平台（`WindowsDeviceInfo`）

Dart 复制代码

WindowsDeviceInfo windowsInfo = await deviceInfoPlugin.windowsInfo;
print('=== Windows 设备信息 ===');
print('设备名称：${windowsInfo.computerName}'); // 电脑名
print('系统版本：${windowsInfo.systemVersion}'); // 例：10.0.22631
print('处理器名称：${windowsInfo.processorName}'); // 例：Intel(R) Core(TM) i7-12700H
print('内存大小(MB)：${windowsInfo.memorySizeInMb}');
print('系统架构：${windowsInfo.systemArchitecture}'); // 例：X64
print('构建号：${windowsInfo.buildNumber}'); // 例：22631

5. macOS 平台（`MacOsDeviceInfo`）

Dart 复制代码

MacOsDeviceInfo macInfo = await deviceInfoPlugin.macOsInfo;
print('=== macOS 设备信息 ===');
print('系统版本：${macInfo.osVersion}'); // 例：14.1.1
print('机型：${macInfo.model}'); // 例：MacBook Pro
print('处理器：${macInfo.processorName}'); // 例：Apple M3 Pro
print('内存大小(GB)：${macInfo.memorySizeInGb}');
print('UUID：${macInfo.systemGUID}'); // 系统唯一标识

三、高级用法：封装与实战场景

1. 封装通用工具类（推荐）

将设备信息获取逻辑封装为全局工具类，避免重复代码：

Dart 复制代码

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

class DeviceInfoUtil {
  static final DeviceInfoPlugin _plugin = DeviceInfoPlugin();
  static bool _isInitialized = false;

  // 初始化（全局调用一次即可）
  static Future<void> init() async {
    if (!_isInitialized) {
      WidgetsFlutterBinding.ensureInitialized();
      _isInitialized = true;
    }
  }

  // 通用：获取设备类型（手机/平板/PC/浏览器）
  static Future<String> getDeviceType() async {
    if (kIsWeb) {
      return "Web浏览器";
    }
    // defaultTargetPlatform 获取 设置的类型 
    switch (defaultTargetPlatform) {
      case TargetPlatform.android:
        final info = await _plugin.androidInfo;
        return info.model.contains("Tablet") ? "安卓平板" : "安卓手机";
      case TargetPlatform.iOS:
        final info = await _plugin.iosInfo;
        return info.model.contains("iPad") ? "iPad" : "iPhone";
      case TargetPlatform.windows:
        return "Windows PC";
      case TargetPlatform.macOS:
        return "Mac电脑";
      case TargetPlatform.linux:
        return "Linux设备";
      default:
        return "未知设备";
    }
  }

  // 通用：获取系统版本（如 "Android 14"、"iOS 17.2"）
  static Future<String> getSystemVersion() async {
    if (kIsWeb) {
      final info = await _plugin.webBrowserInfo;
      return info.platform;
    }
    switch (defaultTargetPlatform) {
      case TargetPlatform.android:
        final info = await _plugin.androidInfo;
        return "Android ${info.version.release}";
      case TargetPlatform.iOS:
        final info = await _plugin.iosInfo;
        return "iOS ${info.systemVersion}";
      case TargetPlatform.windows:
        final info = await _plugin.windowsInfo;
        return "Windows ${info.systemVersion}";
      case TargetPlatform.macOS:
        final info = await _plugin.macOsInfo;
        return "macOS ${info.osVersion}";
      default:
        return "未知系统";
    }
  }

  // Android专属：判断是否为鸿蒙系统（鸿蒙伪装成Android）
  static Future<bool> isHarmonyOS() async {
    if (defaultTargetPlatform != TargetPlatform.android) return false;
    final info = await _plugin.androidInfo;
    // 鸿蒙系统的fingerprint或brand会包含harmony相关字段
    return info.fingerprint.contains("harmony") || info.brand.contains("Harmony");
  }
}

// 使用示例
void main() async {
  await DeviceInfoUtil.init();
  String deviceType = await DeviceInfoUtil.getDeviceType();
  String sysVersion = await DeviceInfoUtil.getSystemVersion();
  bool isHarmony = await DeviceInfoUtil.isHarmonyOS();
  print("设备类型：$deviceType");
  print("系统版本：$sysVersion");
  print("是否鸿蒙：$isHarmony");
}

2. 实战场景 1：版本适配

根据系统版本执行不同逻辑（如 Android 权限适配）：

Dart 复制代码

// Android 13+ 通知权限适配
Future<void> requestNotificationPermission() async {
  final androidInfo = await deviceInfoPlugin.androidInfo;
  if (androidInfo.version.sdkInt >= 33) { // Android 13 (API 33)
    // 请求POST_NOTIFICATIONS权限
    final status = await Permission.notification.request();
    if (status.isGranted) {
      print("通知权限已授予");
    }
  }
}

3. 实战场景 2：埋点统计

收集设备信息用于用户行为分析（合规前提下）：

Dart 复制代码

// 生成埋点用的设备信息JSON
Future<Map<String, dynamic>> getTrackDeviceInfo() async {
  Map<String, dynamic> info = {
    "platform": kIsWeb ? "web" : defaultTargetPlatform.name,
    "device_type": await DeviceInfoUtil.getDeviceType(),
    "system_version": await DeviceInfoUtil.getSystemVersion(),
    "is_emulator": false,
  };

  if (defaultTargetPlatform == TargetPlatform.android) {
    final androidInfo = await deviceInfoPlugin.androidInfo;
    info["manufacturer"] = androidInfo.manufacturer;
    info["model"] = androidInfo.model;
    info["is_emulator"] = !androidInfo.isPhysicalDevice;
  } else if (defaultTargetPlatform == TargetPlatform.iOS) {
    final iosInfo = await deviceInfoPlugin.iosInfo;
    info["model"] = iosInfo.utsname.machine;
    info["is_emulator"] = !iosInfo.isPhysicalDevice;
  }

  return info;
}

四、避坑指南：常见问题与解决方案

1. 权限问题

问题	解决方案
Android 10+ 无法获取`androidId`	改用`identifierForVendor`（iOS）或自定义 UUID（如`flutter_secure_storage`存储）
iOS 获取电池信息失败	需要在`Info.plist`中添加`NSBatteryUsageDescription`说明用途
Web 无法获取精准设备型号	Web 受限于浏览器沙箱，只能通过 UA 解析（可结合第三方库`ua_parser`）

2. 兼容性问题

问题	解决方案
模拟器与真机返回值差异	用`isPhysicalDevice`判断，避免模拟器数据干扰
不同 Android 厂商定制系统字段差异	优先使用`model`/`manufacturer`，避免依赖`fingerprint`等非标字段
macOS 14+ 获取内存信息失败	升级`device_info_plus`到最新版本（>=10.0.0）

3. 性能与异步问题

设备信息获取是异步操作 ，不要在build方法中直接调用，建议在initState或全局初始化时获取；
避免频繁调用（如每次点击按钮都获取），建议缓存结果；
无上下文时必须先调用WidgetsFlutterBinding.ensureInitialized()，否则会崩溃。

总结

核心定位 ：device_info_plus 是 Flutter 多平台设备信息获取的官方首选，替代废弃的device_info，覆盖全平台；
使用原则 ：按平台调用对应info方法，优先封装为工具类，异步操作需处理异常和缓存；
避坑要点 ：注意权限合规、模拟器 / 真机差异、Android 10+ 设备标识限制，无上下文时先初始化WidgetsFlutterBinding。

Flutter ——device_info_plus详解

安装

一、核心基础：包架构与初始化

1. 核心类与初始化

2. 平台与信息类对应表

二、全平台核心 API 详解

1. Android 平台（AndroidDeviceInfo）

2. iOS 平台（IosDeviceInfo）

3. Web 平台（WebBrowserInfo）

4. Windows 平台（WindowsDeviceInfo）

5. macOS 平台（MacOsDeviceInfo）

三、高级用法：封装与实战场景

1. 封装通用工具类（推荐）

2. 实战场景 1：版本适配

3. 实战场景 2：埋点统计

四、避坑指南：常见问题与解决方案

1. 权限问题

2. 兼容性问题

3. 性能与异步问题

总结

1. Android 平台（`AndroidDeviceInfo`）

2. iOS 平台（`IosDeviceInfo`）

3. Web 平台（`WebBrowserInfo`）

4. Windows 平台（`WindowsDeviceInfo`）

5. macOS 平台（`MacOsDeviceInfo`）