Flutter设备营销名称获取插件device_marketing_names的使用

简介

device_marketing_names 是一个简单的设备名称查找包，可以将例如 ‘iPhone13,4’ 映射到 ‘iPhone 12 Pro Max’ 或 ‘SM-G980F’ 映射到 ‘Galaxy S20’。它不需要互联网连接或数据库。

特性

• 查找 Android 营销名称
• 查找 iOS (iPhone & iPad) 营销名称
• 查找浏览器名称
• 获取当前设备或已知 Android 或 iOS 模型的营销名称
• 依赖 device_info_plus 获取 Android 或 iOS 的当前设备模型信息，并依赖 device_identifiers 将其映射为营销名称。浏览器名称直接从 device_info_plus 获取。

使用方法

开始使用

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

dependencies:
  device_marketing_names: ^1.0.0

更多信息请参考 pub.dev。

示例代码

以下是完整的示例代码，展示了如何使用 device_marketing_names 插件来获取设备的营销名称：

import 'dart:async';
import 'package:device_marketing_names/device_marketing_names.dart';
import 'package:flutter/material.dart';

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

class DeviceNamesExample extends StatefulWidget {
  const DeviceNamesExample({Key? key}) : super(key: key);

  @override
  State<DeviceNamesExample> createState() => _DeviceNamesExampleState();
}

class _DeviceNamesExampleState extends State<DeviceNamesExample> {
  String singleDeviceName = "Unknown";
  String singleDeviceNameFromModel = "Unknown";
  String deviceNames = "Unknown";
  String deviceNamesFromModel = "Unknown";

  @override
  void initState() {
    super.initState();
    initPlugin();
  }

  Future<void> initPlugin() async {
    const model = "SM-J250F"; // 示例设备模型
    final deviceMarketingNames = DeviceMarketingNames();
    
    // 获取当前设备的单个营销名称
    final currentSingleDeviceName = await deviceMarketingNames.getSingleName();
    // 获取当前设备的所有可能营销名称
    final currentDeviceNames = await deviceMarketingNames.getNames();
    
    setState(() {
      singleDeviceName = currentSingleDeviceName;
      deviceNames = currentDeviceNames;
      
      // 根据指定模型获取单个营销名称
      singleDeviceNameFromModel = deviceMarketingNames.getSingleNameFromModel(
          DeviceType.android, model);
      // 根据指定模型获取所有可能的营销名称
      deviceNamesFromModel =
          deviceMarketingNames.getNamesFromModel(DeviceType.android, model);
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('DeviceNames example app'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(32.0),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            children: [
              Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text(
                  'First device name:\n$singleDeviceName',
                ),
              ),
              Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text(
                  'All possible device names:\n$deviceNames',
                ),
              ),
              Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text(
                  'First device name for model "SM-J250F":\n$singleDeviceNameFromModel',
                ),
              ),
              Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text(
                  'All possible device names for model "SM-J250F":\n$deviceNamesFromModel',
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

升级指南

如果你从版本 0.3.0 升级到 0.4.0，请注意以下更改：

• 将 getMarketingName() 替换为 getSingleName() 以获取确切的一个匹配名称。
• 将 getMarketingName() 替换为 getNames() 以获取所有匹配名称作为单个字符串，名称之间用 " / " 分隔。
• 将 getMarketingNameFromModel() 替换为 getSingleNameFromModel() 以获取确切的一个匹配名称。
• 将 getMarketingNameFromModel() 替换为 getNamesFromModel() 以获取所有匹配名称作为单个字符串，名称之间用 " / " 分隔。

如何贡献

如果你有兴趣贡献，请参阅 贡献指南。每一个想法、错误报告或代码行都非常受欢迎。

希望这篇文档对你有所帮助！如果有任何问题或需要进一步的帮助，请随时提问。