简单来讲,流程图如下:
简单讲一下整个流程:
我们先写一个AppStrings.dart,这个文件是整个多语言的核心,生成和使用都需要这个文件。在这个文件里可以定义获得文本的api,比如
String order_list_waiting_for_review() => Intl.message( 'Waiting for the review', name: "order_list_waiting_for_review", locale: _localeName );
其中,方法名和name必须保持一致(不要问我为何会有这种坑爹要求)。'Waiting for the review'是默认文案,locale是当前的locale。
这样定义的话,可以用下面的方式获得文本
String text = AppStrings.of(context).order_list_waiting_for_review(); // text == "Waiting for the review"
很好理解,AppStrings.of(context)就是通过context获得对应的locale的AppStrings,进而获得对应的文案。
在上面以那种格式定义后,我们可以执行下面这个命令把AppStrings.dart生成intl_messages.arb
flutter pub pub run intl_translation:extract_to_arb --output-dir=lib/l10n lib/app_strings.dart
*.arb是个中间产物,其内就是JSON文本。其实会有更多附加信息,描述这个文本,不过在此省略。
{ "order_list_waiting_for_review": "Waiting for the review", }
生成的arb文件只是一种语言的,我们可以把它拷贝成N种语言对应的文件,比如intl_en.arb,intl_es.arb等,并把内容的value都替换成对应语言的文案。
然后再执行下面这个命令,生成messages_*.dart
flutter pub pub run intl_translation:generate_from_arb --output-dir=lib/l10n \ --no-use-deferred-loading lib/app_strings.dart lib/l10n/intl_*.arb
可以看到,作为入参的是lib/app_strings.dart和lib/l10n/intl_*.arb,flutter工具党确保lib/app_strings.dart中的方法名、方法中的name参数,和lib/l10n/intl_*.arb中的json的key一致的时候,才会在生成的messages_*.dart文件中加入对应的文案,缺一不可。
我们再回过头来看这段代码
String order_list_waiting_for_review() => Intl.message( 'Waiting for the review', name: "order_list_waiting_for_review", locale: _localeName );
Intl.message()方法实际上是根据locale获取对应的message_*.dart文件,然后再通过name找到对应的文案返回。
当然,还需要对MaterialApp定义localizationsDelegates本地化代理和supportedLocales支持的多语言,这部分在文章最开始的文档里写的很详细了,就不再赘述了。
官方方案的问题
官方的方案虽然很长很繁琐,但还是可以实现多语言的功能的,只是对于我们来讲,它存在以下几个问题:
需要在AppStrings.dart中定义文本获得的方法,一个文本就需要定义一个方法,并且方法名和name必须一致才能和arb文件一起生成最后的dart文件。一个文案对应一个方法,代码写起来很冗余,并且不利于文案的枚举使用(比如文案的key之间有关系)。和native开发之前的习惯也不同。使用和生成的逻辑放到一起,倘若有几千个文案,AppStrings.dart估计要爆表。
流程太长,不利于自动化下载语言的脚本的实现
我们的流程
起点的i18n.py是我们自己写的python脚本,一共有两个作用
从美杜莎(阿里国际化文案管理平台)上获得多语言文案,并重命名成arb文件。
前面说到,arb文件其实是json格式的,美杜莎支持以json格式导出文本,所以我们做的只是重命名,不需要对内容进行更改。
在arb文件处理好后,会拿默认的(英语)文本去生成一个dart文件,这个dart文件只用来作为中间产物,不会被其他dart使用的。
其中只包含如下内容
import 'package:intl/intl.dart'; class MessagesIndex { String order_list_waiting_for_review() => Intl.message( 'Waiting for the review', name: "order_list_waiting_for_review", ); // ...... }
那么,我们继续调用生成最终产物的命令行
flutter pub pub run intl_translation:generate_from_arb --output-dir=lib/l10n \ --no-use-deferred-loading lib/messages_index.dart lib/l10n/intl_*.arb
发现文件以及其内的文案已经被正确生成了。
调用方式
我之所以这样更改流程,其实只有两个目的:
可以像读map一样的读取多语言文案,而不是像调用方法那样去读取。
拉取、生成多语言文案的过程可以自动化。
通过上面一顿操作,生成文案的工作都被自动化搞定了,那我们只需要在AppStrings.dart中添加一个方法,传入name,传出想要的多语言文案即可:
class AppStrings { final String _localeName; // ...... static AppStrings of(BuildContext context) { return Localizations.of<AppStrings>(context, AppStrings); } // AppStrings.of(context).str(stringKey) String str(String name) { return Intl.message(name, name: name, locale: _localeName); } // 重写操作符,减少代码量 // AppStrings.of(context)[stringKey] operator [](String messageName) => str(messageName); }
【本文转载自云栖社区,作者: shoulder ,原文链接:https://yq.aliyun.com/articles/624559?spm=a2c4e.11157919.spm-cont-list.8.146c27aewVdE98】
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。