Flutter设备厂商信息获取插件device_vendor_info的使用

Flutter设备厂商信息获取插件device_vendor_info的使用

1. 简介

device_vendor_info 是一个用于在Flutter环境中获取硬件信息的插件，它提供了关于BIOS、主板和系统的额外信息。这些信息可以帮助软件根据特定的厂商允许或限制某些功能。

2. 使用方法

2.1 安装依赖

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

dependencies:
    device_vendor_info: # 版本约束

2.2 导入与实现

在 Dart 文件中导入 device_vendor_info 并使用其提供的 API 获取硬件信息。以下是一个简单的示例代码，展示了如何获取 BIOS 信息并打印厂商名称：

import 'package:device_vendor_info/device_vendor_info.dart';
import 'package:flutter/widgets.dart';

Future<void> main() async {
    WidgetsFlutterBinding.ensureInitialized();

    final bios = await getBiosInfo();
    print(bios.vendor);
}

2.3 测试

为了确保测试能够在不支持的平台上正常运行，需要在测试代码中调用 overrideCorrectTargetPlatform 并使用 MockDeviceVendorInfoLoader 替换 DeviceVendorInfo.instance。以下是一个完整的测试示例：

// 指定测试平台以防止在不支持的平台上运行时测试失败
@TestOn("windows || mac-os || linux")

import 'package:device_vendor_info/device_vendor_info.dart';
import 'package:device_vendor_info/instance.dart' show DeviceVendorInfo;
import 'package:device_vendor_info/testing.dart';
import 'package:flutter_test/flutter_test.dart';

void main() {
    setUpAll(() {
        // 首先调用此方法
        overrideCorrectTargetPlatform();

        // 将实例替换为模拟加载器
        DeviceVendorInfo.instance = MockDeviceVendorInfoLoader(
          BiosInfo(vendor: "Generic vendor", version: "v1.23", releaseDate: DateTime(2023, 2, 21)),
          BoardInfo(manufacturer: "Default", productName: "", version: ""),
          SystemInfo(family: "", manufacturer: "", productName: "", version: "")
        );
    });

    test("Run test", () {
        // 在这里编写测试实现
    });

    testWidget("Run test with widget", (tester) async {
        // 在这里编写带有 Flutter 小部件的测试
    });
}

3. 完整示例 Demo

以下是一个完整的 Flutter 应用程序示例，展示了如何使用 device_vendor_info 插件来显示设备的硬件信息。这个示例应用程序会显示虚拟化状态、BIOS 信息、主板信息和系统信息。

import 'package:device_vendor_info/device_vendor_info.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:intl/intl.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MaterialApp(home: DeviceInfoPage()));
}

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

  [@override](/user/override)
  State<DeviceInfoPage> createState() => _DeviceInfoPageState();
}

class _DeviceInfoPageState extends State<DeviceInfoPage> {
  Container _buildInfoWidget<T extends Object>(BuildContext context,
      {required String displayName,
      required Future<T> Function() infoFetch,
      required List<ListTile> Function(T info) result}) {
    final ThemeData currentTheme = Theme.of(context);

    return Container(
        constraints: const BoxConstraints(maxWidth: 768),
        margin: const EdgeInsets.symmetric(horizontal: 4, vertical: 10),
        child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Text(displayName,
                  style: TextStyle(
                      color: currentTheme.dividerColor, fontSize: 12)),
              const Divider(),
              FutureBuilder<T>(
                  future: infoFetch(),
                  builder: (context, snapshot) {
                    if (snapshot.hasError) {
                      return const Icon(Icons.error_outline);
                    } else if (!snapshot.hasData ||
                        snapshot.connectionState == ConnectionState.waiting) {
                      return const CircularProgressIndicator();
                    }

                    return Column(
                        mainAxisSize: MainAxisSize.min,
                        children: result(snapshot.data!));
                  })
            ]));
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
        appBar: AppBar(
            backgroundColor: Colors.blue,
            title: Text("当前平台: ${defaultTargetPlatform.name}",
                style: const TextStyle(color: Colors.white))),
        body: Column(children: [
          Expanded(
              child: ListView(children: [
            _buildInfoWidget(context,
                displayName: "虚拟化",
                infoFetch: isVirtualized,
                result: (info) => <ListTile>[
                      ListTile(
                        title: const Text("虚拟化"),
                        trailing: Text(info ? "是" : "否"),
                      )
                    ]),
            _buildInfoWidget<BiosInfo>(context,
                displayName: "BIOS",
                infoFetch: getBiosInfo,
                result: (info) => <ListTile>[
                      ListTile(
                          title: const Text("厂商名称"),
                          trailing: Text(info.vendor ?? "(未知)")),
                      ListTile(
                          title: const Text("版本"),
                          trailing: Text(info.version ?? "(未知)")),
                      ListTile(
                          title: const Text("发布日期"),
                          trailing: Text(info.releaseDate != null
                              ? DateFormat("yyyy-MM-dd")
                                  .format(info.releaseDate!)
                              : "(未知)"))
                    ]),
            _buildInfoWidget<BoardInfo>(context,
                displayName: "主板",
                infoFetch: getBoardInfo,
                result: (info) => <ListTile>[
                      ListTile(
                          title: const Text("产品名称"),
                          trailing: Text(info.productName ?? "(未知)")),
                      ListTile(
                          title: const Text("制造商"),
                          trailing: Text(info.manufacturer ?? "(未知)")),
                      ListTile(
                          title: const Text("版本"),
                          trailing: Text(info.version ?? "(未知)"))
                    ]),
            _buildInfoWidget<SystemInfo>(context,
                displayName: "系统",
                infoFetch: getSystemInfo,
                result: (info) => <ListTile>[
                      ListTile(
                          title: const Text("系列"),
                          trailing: Text(info.family ?? "(未知)")),
                      ListTile(
                          title: const Text("产品名称"),
                          trailing: Text(info.productName ?? "(未知)")),
                      ListTile(
                          title: const Text("制造商"),
                          trailing: Text(info.manufacturer ?? "(未知)")),
                      ListTile(
                          title: const Text("版本"),
                          trailing: Text(info.version ?? "(未知)"))
                    ])
          ]))
        ]));
  }
}