百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

Flutter 实现多语言

wptr33 2025-04-26 21:40 31 浏览

本文同步本人掘金平台的文章:
https://juejin.cn/post/7164571616314130469

我们在处理跨国业务、跨地区(比如港澳台)业务的时候,需要针对当地的语言来做兼容。所以,我们必须处理 app 的多语言。

本文,我们来讲讲,如何结合 flutter_localizations 和 intl 来实现中英文语言的切换。

项目初始化

为了演示多语言的功能,我们新建一个项目:

flutter create jimmy_lang

更改下代码:

// lib/main.dart

import 'package:flutter/material.dart';

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Multiple Languages'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);
  final String title;
  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'Hello World!',
            )
          ],
        ),
      ),
    );
  }
}
复制代码

在 ios 模拟器上的效果:

我们新建了一个很简单的项目。文本 Hello World! 展示在屏幕的正中间。下面我们会对其进行翻译。我们会怎么做呢?请接着往下读...

更新项目 pubspec.yaml 文件

该项目的 pubspec.yaml 中,添加 flutter_localizations 和 intl 包。并设定 generate 为 true,当项目运行起来后,生成本地化工具代码。

dependencies:
  flutter:
    skd: flutter
  # 国际化支持
  flutter_localizations:
    skd: flutter
  intl: ^0.17.0 # 截止更文,该包稳定版本是 0.17.0
  
flutter:
  # 添加代码生成(合成包)支持
  generate: true
复制代码

版本 Flutter 3.0.5 o channel stable o github.com/flutter/flu…

添加文件 l10n.yaml

在项目的根目录(跟 lib 文件夹同级)创建文件 l10n.yaml,添加如下内容:

arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart
复制代码

l10n.yaml 配置文件的用途是:自定义生成将导入应用程序本地化类的工具。

  • arb-dir 指明从哪里找输入的文件,文件夹内包含的文件后缀是 .arb。
  • template-arb-file 模版文件,定义翻译的元数据,该文件必须在 arb-dir 文件夹内创建。
  • output-localization-file 定义该工具将生成的主要 Dart 类文件。并且应用程序将导入。所有生成的文件都是通过文件夹 arb-dir 下的文件生成。

创建模板 ARB 文件,比如 lib/l10n/app_en.arb

比如:

// lib/l10n/app_en.arb
{
  "@@locale": "en",
  
  "helloWorld": "Hello World!"
}
复制代码

@@locale 指明本地化的英文,当然你也可以不要这个声明。通过方法 helloWorld 获取 Hello World! 信息。

此时运行 flutter pub get 获取包,你将生成对应的 dart 工具:

集成自动化生成的本地类

导入上面生成的 app_localizations.dart 文件,在应用中集成 AppLocalizations 类。并使用现在生成的英文本地化 helloWolrd:

// lib/main.dart

import 'package:flutter/material.dart';
import 'package:flutter_gen/gen_l10n/app_localizations.dart'; // 引入对应的本地化类

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      // 添加本地化支持
      localizationsDelegates: AppLocalizations.localizationsDelegates,
      supportedLocales: AppLocalizations.supportedLocales,
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Multiple Languages'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);
  final String title;
  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            // 更改该 Text 文件内容
            Text(
              AppLocalizations.of(context)!.helloWorld, // 注意 !. 的使用
            )
          ],
        ),
      ),
    );
  }
}
复制代码

运行后,在 ios 模拟器上,我们依旧能得到正确的结果:

添加中文语言

我们来添加中文翻译。

我们添加 app_zh.arb 文件:

// lib/l10n/app_zh.arb
{
  "@@locale": "zh",
  
  "helloWorld": "世界,你好"
}
复制代码

重新运行,你会发现在
./dart_tool/flutter_gen/gen_l10n 中多出一份配置 app_localizations_zh.dart 文件 。

我们调整 ios 模拟器中系统设置的语言为中文,再查看 app。

我们 Gif 图走一个

参考

  • Guide for building internationalized Flutter apps

相关推荐

MySQL进阶五之自动读写分离mysql-proxy

自动读写分离目前,大量现网用户的业务场景中存在读多写少、业务负载无法预测等情况,在有大量读请求的应用场景下,单个实例可能无法承受读取压力,甚至会对业务产生影响。为了实现读取能力的弹性扩展,分担数据库压...

Postgres vs MySQL_vs2022连接mysql数据库

...

3分钟短文 | Laravel SQL筛选两个日期之间的记录,怎么写?

引言今天说一个细分的需求,在模型中,或者使用laravel提供的EloquentORM功能,构造查询语句时,返回位于两个指定的日期之间的条目。应该怎么写?本文通过几个例子,为大家梳理一下。学习时...

一文由浅入深带你完全掌握MySQL的锁机制原理与应用

本文将跟大家聊聊InnoDB的锁。本文比较长,包括一条SQL是如何加锁的,一些加锁规则、如何分析和解决死锁问题等内容,建议耐心读完,肯定对大家有帮助的。为什么需要加锁呢?...

验证Mysql中联合索引的最左匹配原则

后端面试中一定是必问mysql的,在以往的面试中好几个面试官都反馈我Mysql基础不行,今天来着重复习一下自己的弱点知识。在Mysql调优中索引优化又是非常重要的方法,不管公司的大小只要后端项目中用到...

MySQL索引解析(联合索引/最左前缀/覆盖索引/索引下推)

目录1.索引基础...

你会看 MySQL 的执行计划(EXPLAIN)吗?

SQL执行太慢怎么办?我们通常会使用EXPLAIN命令来查看SQL的执行计划,然后根据执行计划找出问题所在并进行优化。用法简介...

MySQL 从入门到精通(四)之索引结构

索引概述索引(index),是帮助MySQL高效获取数据的数据结构(有序),在数据之外,数据库系统还维护者满足特定查询算法的数据结构,这些数据结构以某种方式引用(指向)数据,这样就可以在这些数据结构...

mysql总结——面试中最常问到的知识点

mysql作为开源数据库中的榜一大哥,一直是面试官们考察的重中之重。今天,我们来总结一下mysql的知识点,供大家复习参照,看完这些知识点,再加上一些边角细节,基本上能够应付大多mysql相关面试了(...

mysql总结——面试中最常问到的知识点(2)

首先我们回顾一下上篇内容,主要复习了索引,事务,锁,以及SQL优化的工具。本篇文章接着写后面的内容。性能优化索引优化,SQL中索引的相关优化主要有以下几个方面:最好是全匹配。如果是联合索引的话,遵循最...

MySQL基础全知全解!超详细无废话!轻松上手~

本期内容提醒:全篇2300+字,篇幅较长,可搭配饭菜一同“食”用,全篇无废话(除了这句),干货满满,可收藏供后期反复观看。注:MySQL中语法不区分大小写,本篇中...

深入剖析 MySQL 中的锁机制原理_mysql 锁详解

在互联网软件开发领域,MySQL作为一款广泛应用的关系型数据库管理系统,其锁机制在保障数据一致性和实现并发控制方面扮演着举足轻重的角色。对于互联网软件开发人员而言,深入理解MySQL的锁机制原理...

Java 与 MySQL 性能优化:MySQL分区表设计与性能优化全解析

引言在数据库管理领域,随着数据量的不断增长,如何高效地管理和操作数据成为了一个关键问题。MySQL分区表作为一种有效的数据管理技术,能够将大型表划分为多个更小、更易管理的分区,从而提升数据库的性能和可...

MySQL基础篇:DQL数据查询操作_mysql 查

一、基础查询DQL基础查询语法SELECT字段列表FROM表名列表WHERE条件列表GROUPBY分组字段列表HAVING分组后条件列表ORDERBY排序字段列表LIMIT...

MySql:索引的基本使用_mysql索引的使用和原理

一、索引基础概念1.什么是索引?索引是数据库表的特殊数据结构(通常是B+树),用于...