flutter使用package_info_plus库获取应用信息的教程

鹏多多2025-12-16 8:51

1. 简介

在 Flutter 应用开发中，获取应用自身的信息（如应用名称、版本号、包名等）是一项常见需求，这些信息可用于展示在关于页面、用于统计分析或实现特定业务逻辑。package_info_plus 插件是 Flutter 生态中获取应用元数据的最佳选择，支持多平台且使用简单。本文将详细介绍如何使用该插件获取各类应用信息。

package_info_plus 是一个跨平台插件，用于获取应用的包信息和元数据，它是 package_info 插件的升级版，由 Flutter Community 维护。

核心特点：

  • 支持 iOS、Android、Web、Windows、macOS 和 Linux 多平台
  • 能够获取应用名称、包名、版本号、构建号等关键信息
  • 用法简单，API 直观
  • 与最新的 Flutter 版本保持兼容

可获取的主要信息：

  • 应用名称（应用商店中显示的名称）
  • 包名/应用 ID（如 com.example.myapp）
  • 版本名称（如 1.0.0）
  • 版本号/构建号（如 1）
  • 应用签名（部分平台）

2. 安装与配置

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

yaml 复制代码 
dependencies:
  flutter:
    sdk: flutter
  package_info_plus: ^4.0.0  # 使用最新版本

运行以下命令安装依赖：

bash 复制代码 
flutter pub get

2.1. 平台特定配置

package_info_plus 在大多数平台上无需额外配置即可使用，但某些平台可能需要注意以下事项：

Web 平台 ： 需要在 web/index.html 中添加一些元数据，插件会从这里读取信息：

html 复制代码 
<head>
  <!-- 其他头部内容 -->
  <meta name="application-name" content="你的应用名称">
  <meta name="version" content="1.0.0">
  <meta name="build-number" content="1">
  <meta name="package" content="com.example.myapp">
</head>

其他平台： Android、iOS、Windows、macOS 和 Linux 平台不需要额外配置，插件会自动从各自的配置文件中读取信息。

3. 基本使用方法

在需要使用的 Dart 文件中导入 package_info_plus：

dart 复制代码 
import 'package:package_info_plus/package_info_plus.dart';

3.1. 获取应用信息

package_info_plus 提供了一个 PackageInfo 类，通过它可以获取所有应用信息。获取过程是异步的，通常使用 await 关键字：

dart 复制代码 
Future<void> getAppInfo() async {
  PackageInfo packageInfo = await PackageInfo.fromPackageInfo();
  
  String appName = packageInfo.appName;
  String packageName = packageInfo.packageName;
  String version = packageInfo.version;
  String buildNumber = packageInfo.buildNumber;
  
  print('应用名称: $appName');
  print('包名: $packageName');
  print('版本号: $version');
  print('构建号: $buildNumber');
}

3.2. 详细信息说明

PackageInfo 类提供的主要属性：

属性 说明 平台支持
appName 应用的用户可见名称 所有平台
packageName 应用的唯一标识符（Android 的包名，iOS 的 Bundle ID 等） 所有平台
version 应用的版本名称（如 1.0.0） 所有平台
buildNumber 应用的构建号或版本代码（通常是整数） 所有平台
buildSignature 应用的签名信息 Android 特有
installerStore 应用的安装来源商店 Android 特有

4. 实战示例

下面是一个完整的示例，创建一个展示应用信息的"关于"页面：

dart 复制代码 
import 'package:flutter/material.dart';
import 'package:package_info_plus/package_info_plus.dart';

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

  @override
  State<AboutPage> createState() => _AboutPageState();
}

class _AboutPageState extends State<AboutPage> {
  late Future<PackageInfo> _packageInfoFuture;

  @override
  void initState() {
    super.initState();
    // 初始化时获取应用信息
    _packageInfoFuture = PackageInfo.fromPackageInfo();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('关于我们'),
      ),
      body: FutureBuilder<PackageInfo>(
        future: _packageInfoFuture,
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          } else if (snapshot.hasError) {
            return Center(child: Text('获取应用信息失败: ${snapshot.error}'));
          } else if (!snapshot.hasData) {
            return const Center(child: Text('无法获取应用信息'));
          }

          PackageInfo packageInfo = snapshot.data!;

          return SingleChildScrollView(
            padding: const EdgeInsets.all(16.0),
            child: Column(
              children: [
                // 应用图标
                const CircleAvatar(
                  radius: 60,
                  child: Icon(Icons.android, size: 60), // 实际项目中替换为应用图标
                ),
                const SizedBox(height: 24),
                
                // 应用名称
                Text(
                  packageInfo.appName,
                  style: Theme.of(context).textTheme.headlineMedium,
                ),
                const SizedBox(height: 8),
                
                // 版本信息
                Text(
                  '版本: ${packageInfo.version} (${packageInfo.buildNumber})',
                  style: Theme.of(context).textTheme.titleMedium,
                ),
                const SizedBox(height: 24),
                
                // 详细信息列表
                _buildInfoItem('包名', packageInfo.packageName),
                if (packageInfo.buildSignature.isNotEmpty)
                  _buildInfoItem('应用签名', packageInfo.buildSignature),
                if (packageInfo.installerStore != null && packageInfo.installerStore!.isNotEmpty)
                  _buildInfoItem('安装来源', packageInfo.installerStore!),
                
                const SizedBox(height: 32),
                
                // 版权信息
                const Text(
                  '© 2023 你的公司名称. 保留所有权利.',
                  style: TextStyle(color: Colors.grey),
                ),
              ],
            ),
          );
        },
      ),
    );
  }

  // 构建信息项
  Widget _buildInfoItem(String label, String value) {
    return Padding(
      padding: const EdgeInsets.symmetric(vertical: 8.0),
      child: Row(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Text(
            '$label: ',
            style: const TextStyle(
              fontWeight: FontWeight.bold,
              width: 100,
            ),
          ),
          Expanded(
            child: Text(value),
          ),
        ],
      ),
    );
  }
}

这个示例创建了一个完整的"关于"页面，包含以下功能：

  • 使用 FutureBuilder 处理异步获取应用信息的过程
  • 展示加载状态、错误状态和成功状态
  • 显示应用名称、图标、版本号等基本信息
  • 根据平台特性选择性展示签名和安装来源信息

5. 高级应用场景

下面是一些高级的应用场景，例如：

5.1. 版本更新检查

可以使用获取到的版本号实现版本更新检查功能：

dart 复制代码 
class VersionChecker {
  // 假设这是从服务器获取的最新版本号
  final String _latestVersion = "1.1.0";
  
  Future<bool> isUpdateAvailable() async {
    PackageInfo packageInfo = await PackageInfo.fromPackageInfo();
    return _compareVersions(packageInfo.version, _latestVersion) < 0;
  }
  
  // 版本号比较工具方法
  int _compareVersions(String current, String latest) {
    List<int> currentParts = current.split('.').map(int.parse).toList();
    List<int> latestParts = latest.split('.').map(int.parse).toList();
    
    int maxLength = max(currentParts.length, latestParts.length);
    
    for (int i = 0; i < maxLength; i++) {
      int currentPart = i < currentParts.length ? currentParts[i] : 0;
      int latestPart = i < latestParts.length ? latestParts[i] : 0;
      
      if (currentPart < latestPart) return -1;
      if (currentPart > latestPart) return 1;
    }
    
    return 0;
  }
}

// 使用示例
void checkForUpdates() async {
  VersionChecker checker = VersionChecker();
  bool hasUpdate = await checker.isUpdateAvailable();
  if (hasUpdate) {
    // 显示更新提示
    print("有新版本可用！");
  }
}

5.2. 应用使用统计

结合设备信息和应用信息，可以实现应用使用统计：

dart 复制代码 
import 'package:device_info_plus/device_info_plus.dart';

Future<void> trackAppUsage() async {
  PackageInfo packageInfo = await PackageInfo.fromPackageInfo();
  DeviceInfoPlugin deviceInfo = DeviceInfoPlugin();
  
  String trackingInfo = '''
  应用信息:
  - 名称: ${packageInfo.appName}
  - 版本: ${packageInfo.version}
  - 包名: ${packageInfo.packageName}
  
  设备信息:
  ''';
  
  if (Platform.isAndroid) {
    AndroidDeviceInfo androidInfo = await deviceInfo.androidInfo;
    trackingInfo += '- 设备: ${androidInfo.brand} ${androidInfo.model}\n';
    trackingInfo += '- 系统版本: Android ${androidInfo.version.release}';
  } else if (Platform.isIOS) {
    IosDeviceInfo iosInfo = await deviceInfo.iosInfo;
    trackingInfo += '- 设备: ${iosInfo.model}\n';
    trackingInfo += '- 系统版本: iOS ${iosInfo.systemVersion}';
  }
  
  // 实际项目中，这里会将统计信息发送到服务器
  print(trackingInfo);
}

5.3. 动态配置应用行为

根据应用版本动态配置应用行为：

dart 复制代码 
Future<void> configureAppBehavior() async {
  PackageInfo packageInfo = await PackageInfo.fromPackageInfo();
  
  // 根据不同版本启用不同功能
  if (packageInfo.version.startsWith('1.0.')) {
    // v1.0.x 版本的配置
    print('配置基础功能');
  } else if (packageInfo.version.startsWith('1.1.')) {
    // v1.1.x 版本的配置
    print('配置高级功能');
  }
  
  // 根据构建号启用测试功能
  int buildNumber = int.tryParse(packageInfo.buildNumber) ?? 0;
  if (buildNumber >= 100) {
    print('启用beta功能');
  }
}

6. 注意事项

  • 异步处理
    • PackageInfo.fromPackageInfo() 是异步方法，必须正确处理异步操作
    • 建议在应用启动时获取一次应用信息并缓存，避免重复获取
    • 使用 FutureBuilder 或状态管理工具（如 Provider、Bloc）处理 UI 渲染
  • 平台差异
    • 不同平台上的信息可能有所不同，尤其是 buildSignature 和 installerStore 等平台特定属性
    • Web 平台需要手动配置元数据，其他平台则自动读取
    • 处理平台特定属性时，应先检查其是否存在或不为空
  • 版本号管理
    • 保持 pubspec.yaml、AndroidManifest.xml 和 Info.plist 中的版本信息同步
    • 建立清晰的版本号命名规则（如语义化版本 主版本.次版本.修订号）
    • 构建号应随每次构建递增，用于区分不同构建
  • 性能考虑
    • 应用信息不会频繁变化，无需多次获取
    • 建议在应用初始化阶段获取并存储在全局状态中
    • 避免在 UI 渲染关键路径中获取应用信息

7. 常见问题解决

  • 信息不准确或未更新
    • 确保所有平台的配置文件都已更新版本信息
    • 运行 flutter clean 清理缓存后重新构建
    • 对于 Web 平台，检查 index.html 中的元数据是否正确
  • 某些属性为空
    • 某些属性（如 installerStore）仅在特定条件下才有值
    • 检查是否在正确的平台上访问平台特定属性
    • Web 平台需要手动配置所有属性
  • 构建错误
    • 确保使用的 package_info_plus 版本与 Flutter 版本兼容
    • 检查是否正确导入了包
    • 尝试更新插件到最新版本

8. 总结

package_info_plus 是 Flutter 开发中获取应用元数据的实用工具，它提供了简单直观的 API，支持多平台，能够满足大多数应用对获取自身信息的需求。

合理利用应用信息可以提升用户体验，简化开发流程，并为应用的统计分析提供支持。更多详细信息可以参考 官方文档。

本次分享就到这儿啦，我是鹏多多，深耕前端的技术创作者，如果您看了觉得有帮助，欢迎评论，关注，点赞，转发，我们下次见~

PS：在本页按F12，在console中输入document.getElementsByClassName('panel-btn')[0].click();有惊喜哦~

往期文章

相关推荐
冬男zdn6 小时前
Vue 3 从基础到高阶全攻略
前端·javascript·vue.js
走在路上的菜鸟6 小时前
Android学Dart学习笔记第十五节 类
android·笔记·学习·flutter
BigPomme6 小时前
Flutter IOS 出现实机运行问题和transpoter传包异常
flutter·ios
亿元程序员6 小时前
Cocos游戏开发中的箭头游戏效果
前端
2501_916008896 小时前
IOScer 证书到底是什么和怎么使用的完整说明
android·ios·小程序·https·uni-app·iphone·webview
冬男zdn6 小时前
前端可视化图表库精选与实战指南
前端·javascript
还是大剑师兰特6 小时前
前端设计模式：详解、应用场景与核心对比
前端·设计模式·大剑师
局外人LZ6 小时前
前端二维码技术全景：从原生JS到Vue/React/Uniapp/小程序的二维码生成
前端·javascript
热门推荐
01GitHub 镜像站点02UV安装并设置国内源03【AutoGLM部署】本地私有化部署AI手机Agent04Linux下V2Ray安装配置指南05Cursor 又偷偷更新，这个功能太实用：Visual Editor for Cursor Browser06Open-AutoGLM Windows 安装部署教程07【超详细教程】手把手教你从微软官网免费下载Windows 10官方原版ISO镜像（2025最新版）08在VSCode配置Java开发环境的保姆级教程（适配各类AI编程IDE）09BongoCat - 跨平台键盘猫动画工具10安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）