Flutter本地化插件fast_localization的使用

快速本地化解决方案

fast_localization 是一个为 Flutter 应用程序提供的快速本地化解决方案，使用 Dart 的 Map 实现。无需为每个本地化项使用 context。

开始使用

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

dependencies:
  fast_localization: <last_version>

示例代码

最小化配置（内置 fast_localization MaterialApp）

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

void main() async {
  // 4. 声明本地化语言
  final locales = {
    Locale('en'): {
      "title": "Demo",
      "welcome": "Hello World!",
    },
    Locale('ar'): {
      "title": "عرض",
      "welcome": "أهلاً بالعالم!",
    },
  };

  // 5. 加载本地化资源
  await Localization.load(locales);

  // 6. 使用 LocalizationApp
  runApp(LocalizationApp(
    title: () => Localization.translate('title'), // MaterialApp(title)
    home: () => HomeScreen(), // MaterialApp(home)
    theme: ThemeData.light(), // MaterialApp(theme)
  ));
}

class HomeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(Localization.translate('title')), // 设置标题
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('😉', style: TextStyle(fontSize: 50)),
            Text(Localization.translate('title'), style: TextStyle(fontSize: 25)),
            SizedBox(height: 60),
            TextButton(
              child: Text('English'),
              onPressed: () {
                Localization.changeLocale(Locale('en'), context); // 切换到英文
              },
            ),
            TextButton(
              child: Text('عربي'),
              onPressed: () {
                Localization.changeLocale(Locale('ar'), context); // 切换到阿拉伯文
              },
            ),
          ],
        ),
      ),
    );
  }
}

灵活配置

如果需要使用自定义的 MaterialApp、CupertinoApp 或 WidgetsApp，可以按以下方式配置：

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:fast_localization/fast_localization.dart';

void main() async {
  // 4. 声明本地化语言
  final locales = {
    Locale('en'): {
      "title": "Demo",
      "welcome": "Hello World!",
    },
    Locale('ar'): {
      "title": "عرض",
      "welcome": "أهلاً بالعالم!",
    },
  };

  // 5. 加载本地化资源
  await Localization.load(locales);

  // 6. 使用 LocalizationApp
  runApp(LocalizationApp(
    child: (context) => MyApp(),
  ));
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: Localization.translate('title'), // 设置标题
      home: HomeScreen(), // 设置首页
      theme: ThemeData.light(), // 设置主题
      localizationsDelegates: [
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
        FastLocalizationsDelegate(),
      ],
      supportedLocales: Localization.supportedLocales,
    );
  }
}

使用 LocalizationApp(...)

最小化配置

灵活配置

注意：只能选择 Minimal 或 Flexible 中的一种。

使用 Localization

函数

字段

注意：有一个全局别名 Localization.translate(key, params)，即 t(key, params)！

本地化声明

平坦结构

final en = {
  "title": "Demo",
  "welcome": "Hello World!",
};

使用方法：

Localization.translate('welcome');
Localization.t('welcome');
t('welcome');

嵌套结构

final en = {
  "app": {
    "name": "Demo",
    "description": "A demo app",
  },
};

使用方法：

Localization.translate('app.name');
Localization.t('app.name');
t('app.name');

带参数

final en = {
  "info": {
    "name": "My name is {{name}}",
  },
};

使用方法：

Localization.translate('info.name', {"name": "Hasan"});
Localization.t('info.name', {"name": "Hasan"});
t('info.name', {"name": "Hasan"});