Flutter本地化管理插件debug_bricks_easy_localization的使用

简介

debug_bricks_easy_localization 是一个用于显示当前语言环境信息并允许更改语言环境的 UI 组件。该插件依赖于 easy_localization 包作为其本地化框架。

依赖项

要使用此插件，必须先设置并使用 easy_localization。在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  debug_bricks_easy_localization: <last_version>

然后运行 flutter pub get 安装依赖。

使用方法

EasyLocalizationBrick

EasyLocalizationBrick 是一个可以显示当前语言环境并允许用户更改语言环境的组件。

示例代码

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

class DebugScreen extends StatelessWidget {
  const DebugScreen({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return EasyLocalizationBrick(
      title: 'Language', // 设置标题
    );
  }
}

自定义适配器

可以通过传递自定义的 localeAdapter 实例来自定义输出。

class CustomLocaleAdapter {
  const CustomLocaleAdapter();

  String convert(Locale locale) {
    // 格式化语言环境
    return '${locale.languageCode}-${locale.countryCode}';
  }
}

// 在使用时：
EasyLocalizationBrick(
  title: 'Language',
  localeAdapter: CustomLocaleAdapter(), // 使用自定义适配器
);

LocalizationsTable

LocalizationsTable 是一个用于显示所有支持的语言键值对的表格组件。

示例代码

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

class DebugScreen extends StatelessWidget {
  const DebugScreen({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return LocalizationsTable(
      mapLocales: CodegenLoader.mapLocales, // 加载的语言映射
    );
  }
}

自定义资源提供者

可以通过传递自定义的 ResourcesProvider 类来自定义表格的翻译。

class AppResourcesProvider extends ResourcesProvider {
  [@override](/user/override)
  String get titleKey => LocaleKeys.localizations_table_column_key.tr(); // 表格列名
  [@override](/user/override)
  String get titleValue => LocaleKeys.localizations_table_column_value.tr(); // 表格值
}

// 在使用时：
LocalizationsTable(
  mapLocales: CodegenLoader.mapLocales,
  resourcesProvider: AppResourcesProvider(), // 使用自定义资源提供者
);