Flutter iOS构建信息获取插件build_info_ios的使用

Flutter iOS构建信息获取插件build_info_ios的使用

1. 插件简介

build_info_ios 是 build_info 包的 iOS 实现。它允许你在 Flutter 应用中获取 iOS 构建信息，如构建日期和安装日期。

2. 使用方法

该插件是官方推荐的联合插件（endorsed federated plugin），这意味着你可以直接在项目中使用 build_info，而不需要显式地将 build_info_ios 添加到 pubspec.yaml 文件中。不过，如果你需要直接使用 build_info_ios 的 API，仍然需要在 pubspec.yaml 中添加它。

3. iOS 版本实现原理

build_info_ios 的工作原理如下：

1. 通过 Flutter 调用 BuildInfo.fromPlatform 方法。
2. 使用 path(forResource:ofType:) 获取 Info.plist 文件的最后修改日期和时间，并将其作为构建日期和时间。
3. 获取 Document Directory 的创建日期和时间，并将其作为安装日期和时间。
4. 返回步骤 2 和 3 中获取的值。

如果无法获取这些日期和时间，则返回 null。

4. 完整示例 Demo

以下是一个完整的示例代码，展示了如何在 Flutter 应用中使用 build_info_ios 插件来获取构建信息并显示在界面上。

// 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_ios/build_info_ios.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 _buildInfoIOSPlugin = BuildInfoIOS(); // 创建 BuildInfoIOS 实例

  [@override](/user/override)
  void initState() {
    super.initState();
    initBuildInfoState(); // 初始化构建信息
  }

  // 异步方法，用于从平台获取构建信息
  Future<void> initBuildInfoState() async {
    BuildInfoData? buildInfoData;
    
    try {
      // 从平台获取构建信息
      buildInfoData = await _buildInfoIOSPlugin.fromPlatform();
    } on PlatformException catch (e, stackTrace) {
      // 捕获平台异常并打印错误信息
      debugPrint(e.message);
      debugPrintStack(stackTrace: stackTrace);
    }

    // 如果 widget 已经被移除，则不再更新状态
    if (!mounted) return;

    setState(() {
      _buildInfoData = buildInfoData; // 更新构建信息
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Text('BuildDate: ${_buildInfoData?.buildDate}'), // 显示构建日期
              Text('InstallDate: ${_buildInfoData?.installDate}'), // 显示安装日期
            ],
          ),
        ),
      ),
    );
  }
}