Flutter用户代理管理插件ua_client_helper的使用

插件简介

此插件提供了对用户代理（User-Agent）信息的管理和获取功能。通过该插件，您可以轻松获取设备的详细信息，并将其用于网络请求或日志记录等场景。

插件特性

• Null安全：完全支持Flutter的null安全性。
• 多平台支持：适用于Android和iOS设备。
• 丰富的API：提供多种方式获取用户代理信息。

安装

在您的pubspec.yaml文件中添加以下依赖：

dependencies:
  ua_client_hints: ^1.x.x

然后运行以下命令安装依赖：

$ flutter pub get

使用方法

示例代码

以下是一个完整的示例代码，展示如何使用ua_client_helper插件来获取用户代理信息并显示在界面上。

示例代码：lib/main.dart

import 'package:flutter/material.dart';
import 'package:ua_client_hints/ua_client_helper.dart';

void main() async {
  // 初始化Flutter绑定
  WidgetsFlutterBinding.ensureInitialized();

  // 获取用户代理信息
  final ua = await userAgent();
  final uaData = await userAgentData();
  final header = await userAgentClientHintsHeader();

  runApp(MyApp(
    userAgent: ua,
    userAgentData: uaData,
    userAgentHeader: header,
  ));
}

class MyApp extends StatelessWidget {
  final String userAgent;
  final UserAgentData userAgentData;
  final Map<String, dynamic> userAgentHeader;

  const MyApp({
    required this.userAgent,
    required this.userAgentData,
    required this.userAgentHeader,
  });

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text("User-Agent Client Hints"),
        ),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
            // 用户代理信息
            const Text(
              "## User-Agent ##",
              style: TextStyle(fontWeight: FontWeight.bold),
            ),
            Text("User-Agent: $userAgent"),

            // 用户代理数据
            const Text(
              "## User-Agent Client Hints ##",
              style: TextStyle(fontWeight: FontWeight.bold),
            ),
            Text("platform: ${userAgentData.platform}"),
            Text("platformVersion: ${userAgentData.platformVersion}"),
            Text("architecture: ${userAgentData.architecture}"),
            Text("model: ${userAgentData.model}"),
            Text("brand: ${userAgentData.brand}"),
            Text("mobile: ${userAgentData.mobile}"),
            Text("device: ${userAgentData.device}"),
            Text("appName: ${userAgentData.package.appName}"),
            Text("appVersion: ${userAgentData.package.appVersion}"),
            Text("packageName: ${userAgentData.package.packageName}"),
            Text("buildNumber: ${userAgentData.package.buildNumber}"),

            // 用户代理头部信息
            const Text(
              "## User-Agent Client Hints Headers ##",
              style: TextStyle(fontWeight: FontWeight.bold),
            ),
            Text("User-Agent: ${userAgentHeader['User-Agent']}"),
            Text("Sec-CH-UA-Arch: ${userAgentHeader['Sec-CH-UA-Arch']}"),
            Text("Sec-CH-UA-Model: ${userAgentHeader['Sec-CH-UA-Model']}"),
            Text("Sec-CH-UA-Platform: ${userAgentHeader['Sec-CH-UA-Platform']}"),
            Text("Sec-CH-UA-Platform-Version: ${userAgentHeader['Sec-CH-UA-Platform-Version']}"),
            Text("Sec-CH-UA: ${userAgentHeader['Sec-CH-UA']}"),
            Text("Sec-CH-UA-Full-Version: ${userAgentHeader['Sec-CH-UA-Full-Version']}"),
            Text("Sec-CH-UA-Mobile: ${userAgentHeader['Sec-CH-UA-Mobile']}"),
          ],
        ),
      );
    }
  }
}

API说明

获取用户代理字符串

final String ua = await userAgent();
print('User-Agent: $ua');  // e.g.. 'SampleApp/1.0.0 (Android 11; Pixel 4 XL; coral; arm64-v8a)'

获取用户代理数据对象

final UserAgentData uaData = await userAgentData();

print('platform:        ${uaData.platform}');              // e.g.. 'Android'
print('platformVersion: ${uaData.platformVersion}');       // e.g.. '10'
print('model:           ${uaData.model}');                 // e.g.. 'Pixel 4 XL'
print('architecture:    ${uaData.architecture}');          // e.g.. 'arm64-v8a'
print('brand:           ${uaData.brand}');                 // e.g.. 'google'
print('mobile:          ${uaData.mobile}');                // e.g.. true
print('device:          ${uaData.device}');                // e.g.. 'coral'
print('appName:         ${uaData.package.appName}');       // e.g.. 'SampleApp'
print('appVersion:      ${uaData.package.appVersion}');    // e.g.. '1.0.0'
print('packageName:     ${uaData.package.packageName}');   // e.g.. 'jp.wasabeef.ua'
print('buildNumber:     ${uaData.package.buildNumber}');   // e.g.. '1'

获取用户代理头部信息

final Map<String, dynamic> header = await userAgentClientHintsHeader();

print("Sec-CH-UA-Arch:             ${header['Sec-CH-UA-Arch']}");             // e.g.. 'arm64-v8a'
print("Sec-CH-UA-Model:            ${header['Sec-CH-UA-Model']}");            // e.g.. 'Pixel 4 XL'
print("Sec-CH-UA-Platform:         ${header['Sec-CH-UA-Platform']}");         // e.g.. 'Android'
print("Sec-CH-UA-Platform-Version: ${header['Sec-CH-UA-Platform-Version']}"); // e.g.. '10'
print("Sec-CH-UA:                  ${header['Sec-CH-UA']}");                  // e.g.. '"SampleApp"; v="1.0.0"'
print("Sec-CH-UA-Full-Version:     ${header['Sec-CH-UA-Full-Version']}");     // e.g.. '1.0.0'
print("Sec-CH-UA-Mobile:           ${header['Sec-CH-UA-Mobile']}");           // e.g.. '?1' (true) or '?0' (false)