Flutter国际化插件locale_plus的使用

Locale Plus

LocalePlus 是一个Flutter包，它允许开发人员轻松地从本地设备区域设置中检索数据。通过LocalePlus，开发人员可以访问诸如设备的语言、国家代码和时区等信息，以及设备的数字格式化偏好，如分组和小数分隔符。这使得构建国际化的应用程序变得简单，为每个用户提供个性化的体验。

目录

• 概述
• 要求
• 安装
• 用法
• 作者
• 贡献者
• 许可证

概述

LocalePlus是一个Flutter包，它允许开发人员轻松地从本地设备区域设置中检索数据。通过LocalePlus，开发人员可以访问诸如设备的语言、国家代码和时区等信息，以及设备的数字格式化偏好，如分组和小数分隔符。这使得构建国际化的应用程序变得简单，为每个用户提供个性化的体验。

要求

• Dart SDK: >=3.0.0 <4.0.0
• Flutter: >=3.10.0
• Android: minSdkVersion 16
• iOS 9.0+

安装

可以通过以下命令安装locale_plus：

$ flutter pub add locale_plus

在pubspec.yaml文件中会添加如下依赖（并隐式运行flutter pub get）：

dependencies:
  locale_plus: ^1.6.0

用法

补丁修复分隔符

该功能会修补所有Flutter中的区域设置，以便在补丁完成后可以从numberFormatSymbols中使用小数分隔符和分组分隔符。patchNumberSeperators函数会在Android和iOS上修补区域设置。shouldPatchForSamsungKeyboard选项可以启用，以修补三星键盘上的输入（它们仅允许.作为输入）。调用此方法在MacOS、Windows、Linux和Web上是安全的，但不会修补区域设置。

import 'package:locale_plus/locale_plus.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await PatchAllLocales.patchNumberSeperators(
    shouldPatchForSamsungKeyboard: true,
  );
  runApp(const MyApp());
}

获取用户是否使用三星键盘

final decimalSeparator = await LocalePlus().isUsingSamsungKeyboard();

获取小数分隔符和分组分隔符

final decimalSeparator = await LocalePlus().getDecimalSeparator();
final groupingSeparator = await LocalePlus().getGroupingSeparator();

获取语言代码和地区代码

final regionCode = await LocalePlus().getRegionCode();
final languageCode = await LocalePlus().getLanguageCode();

获取与GMT的时间差（秒）

final secondsFromGMT = await LocalePlus().getSecondsFromGMT();

设备是否使用24小时制及当前区域设置的AM/PM符号

final is24HourTime = await LocalePlus().is24HourTime();
final amSymbol = await LocalePlus().getAmSymbol();
final pmSymbol = await LocalePlus().getPmSymbol();

设备是否使用公制系统

final usesMetricSystem = await LocalePlus().usesMetricSystem();

获取时区标识符

final timeZoneIdentifier = await LocalePlus().getTimeZoneIdentifier();

获取一周的第一天

final firstDayOfWeek = await LocalePlus().getFirstDayOfWeek();

示例应用

下面是一个完整的示例应用，展示了如何使用locale_plus插件获取各种本地化信息：

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

import 'package:locale_plus/locale_plus.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await PatchAllLocales.patchNumberSeperators(
    patchForSamsungKeyboards: true,
  );
  runApp(const MyApp());
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String? decimalSeparator;
  String? groupingSeparator;
  bool? isUsingSamsungKeyboard;
  int? secondsFromGMT;
  String? regionCode;
  String? languageCode;
  bool? usesMetricSystem;
  bool? is24HourTime;
  String? amSymbol;
  String? pmSymbol;
  String? timeZoneIdentifier;
  int? firstDayOfWeek;

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

  Future<void> initPlatformState() async {
    decimalSeparator = await LocalePlus().getDecimalSeparator();
    groupingSeparator = await LocalePlus().getGroupingSeparator();
    isUsingSamsungKeyboard = await LocalePlus().isUsingSamsungKeyboard();
    secondsFromGMT = await LocalePlus().getSecondsFromGMT();
    regionCode = await LocalePlus().getRegionCode();
    languageCode = await LocalePlus().getLanguageCode();
    usesMetricSystem = await LocalePlus().usesMetricSystem();
    is24HourTime = await LocalePlus().is24HourTime();
    amSymbol = await LocalePlus().getAmSymbol();
    pmSymbol = await LocalePlus().getPmSymbol();
    timeZoneIdentifier = await LocalePlus().getTimeZoneIdentifier();
    firstDayOfWeek = await LocalePlus().getFirstDayOfWeek();
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            children: [
              Text(
                'Decimal Separator: $decimalSeparator',
                textAlign: TextAlign.center,
              ),
              Text(
                'Grouping Separator: $groupingSeparator',
                textAlign: TextAlign.center,
              ),
              Text(
                'is using samsung keyboard: $isUsingSamsungKeyboard',
                textAlign: TextAlign.center,
              ),
              Text(
                'Seconds From GMT: $secondsFromGMT',
                textAlign: TextAlign.center,
              ),
              Text(
                'Region Code: $regionCode',
                textAlign: TextAlign.center,
              ),
              Text(
                'Language Code: $languageCode',
                textAlign: TextAlign.center,
              ),
              Text(
                'Uses Metric System: $usesMetricSystem',
                textAlign: TextAlign.center,
              ),
              Text(
                'Is 24 Hour Time: $is24HourTime',
                textAlign: TextAlign.center,
              ),
              Text(
                'AM Symbol: $amSymbol',
                textAlign: TextAlign.center,
              ),
              Text(
                'PM Symbol: $pmSymbol',
                textAlign: TextAlign.center,
              ),
              Text(
                'Time Zone Identifier: $timeZoneIdentifier',
                textAlign: TextAlign.center,
              ),
              Text(
                'First day of week: $firstDayOfWeek',
                textAlign: TextAlign.center,
              ),
            ],
          ),
        ),
      ),
    );
  }
}

作者

Gökberk Bardakçı, Uygar İşiçelik

贡献者

Bent Engbers, Renat Shakhmatov, Giovanni Lattanzio, Gökhan Çavuş

许可证

LocalePlus在MIT许可证下可用。更多信息请参阅LICENSE文件。