Flutter Windows构建信息获取插件build_info_windows的使用

Flutter Windows构建信息获取插件build_info_windows的使用

使用

这个包是被支持的，这意味着你可以像使用普通的包一样使用build_info。当你这样做时，这个包会自动包含在你的应用中，因此你不需要在pubspec.yaml文件中添加它。

然而，如果你导入这个包来直接使用它的API，你应该像往常一样将它添加到你的pubspec.yaml文件中。

关于Windows版本的实现

Windows版本的build_info的工作方式如下：

1. 从Flutter调用BuildInfo.fromPlatform方法。
2. 获取IMAGE_NT_HEADERS64结构，并使用IMAGE_FILE_HEADER结构中的TimeDateStamp值作为构建日期和时间。
3. 使用可执行文件的创建日期和时间或可执行文件所在目录的创建日期和时间中较早的一个作为安装日期和时间。

如果无法获取每个日期和时间，则它们将为null。

IMAGE_FILE_HEADER结构中用于构建日期和时间的TimeDateStamp字段是DWORD类型，因此在2106年2月7日06:28:15 UTC之后会溢出。因此，如果接收到的是2024年1月1日00:00:00 UTC之前的时间戳，将会加上0x100000000。（日期格式yyyy/mm/dd）

int64_t _tmp = inh.FileHeader.TimeDateStamp;
if (_tmp < 1704067200 /* 2024-01-01 00:00:00 UTC */) {
    _tmp += 0x100000000;
}

示例代码

以下是一个完整的示例代码，展示了如何使用build_info_windows插件来获取构建和安装日期。

// Copyright 2024 Craftsoft LLC. All rights reserved.
// Use of this source code is governed by a MIT-style license that can be
// found in the LICENSE file.

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:build_info_platform_interface/build_info_data.dart';
import 'package:build_info_windows/build_info_windows.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  BuildInfoData? _buildInfoData;
  final _buildInfoWindowsPlugin = BuildInfoWindows();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    BuildInfoData? buildInfoData;
    // 平台消息可能会失败，所以我们使用try/catch处理PlatformException。
    // 我们还处理消息可能返回null的情况。
    try {
      buildInfoData = await _buildInfoWindowsPlugin.fromPlatform();
    } on PlatformException catch (e, stackTrace) {
      debugPrint(e.message);
      debugPrintStack(stackTrace: stackTrace);
    }

    // 如果在异步平台消息飞行期间小部件从树中移除，我们想要丢弃回复而不是调用setState来更新我们的不存在的外观。
    if (!mounted) return;

    setState(() {
      _buildInfoData = buildInfoData;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Text('BuildDate: ${_buildInfoData?.buildDate}'),
              Text('InstallDate: ${_buildInfoData?.installDate}'),
            ],
          ),
        ),
      ),
    );
  }
}