搜索插件、代码仓与 APP 分类

fluintl 封面
插件详情v2.0.0

fluintl

一个 Flutter 国际化支持包。使用它可快速构建国际化应用。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
202
喜欢数
3
Pub 分数
150

安装插件

flutter pub add fluintl

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

fluintl 是一个 Flutter 包,旨在简化应用程序中的国际化,使开发者能够快速实现多语言支持。它提供了一个易于使用的 API 来管理翻译、处理区域设置更改以及支持动态内容。通过内置的工具加载语言文件,并在运行时切换语言,fluintl 简化了构建全球可访问应用的过程。它与 Flutter 的组件树无缝集成,并支持所有主要平台,包括 Android、iOS、Web、macOS、Windows 和 Linux。

适合场景

  • 构建多语言移动和网络应用程序
  • 支持动态语言切换
  • 高效管理应用翻译
  • 将本地化集成到现有的 Flutter 项目中
  • 创建用户友好的国际化UI

主要特点

  • 轻松的翻译文件管理
  • 运行时区域设置切换
  • 支持复数和性别形式
  • 内置回退机制
  • 与 Flutter 小部件的无缝集成

适合对象

  • 开发全球应用的开发者
  • 管理多种语言资源的团队
  • 需要快速国际化设置的项目
  • 针对不同地区受众的应用程序
  • Flutter 初学者学习本地化

使用建议

  • 需要手动设置翻译文件
  • 有限的内置翻译编辑工具
  • 大规模翻译工作流可能需要额外的工具
  • 不适合实时协作翻译
  • 依赖于跨语言的一致性密钥命名

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

README of English

fluintl (Flutter 国际化)

Pub

fluintl 是一个为应用提供国际化的库,可快速集成实现应用多语言。该库封装了一个国际化支持类,通过提供统一方法getString(id)获取字符串。CustomLocalizations多语言支持类。LBaseState可简洁获取字符串。

使用方式:
dependencies:
  fluintl: ^2.0.0  
v0.1.3(2019.03.25)

支持复用。

 //替换字符串格式要求:'%\${index}\$s' ,{index} 第几个参数,从0开始。

 Ids.click_times: '%\$0\$s点击了%\$1\$s次',   
   
 IntlUtil.getString(context, Ids.click_times, params: ['Tom', '$_counter'])  
 // print: Tom点击了0次
使用步骤:

1.创建多语言资源字符串id管理类Ids 和 多语言资源Map

///多语言资源id管理类.  
class Ids {  
  static String titleHome = 'title_home'; 
}  
///简单多语言资源.  
Map<String, Map<String, String>> localizedSimpleValues = {  
  'en': {    
    Ids.titleHome: 'Home',  
  },  
  'zh': {    
    Ids.titleHome: '主页',  
  },  
};  
///多语言资源.  
Map<String, Map<String, Map<String, String>>> localizedValues = {  
  'en': {  
    'US': {  
      Ids.titleHome: 'Home',  
    }  
  },  
  'zh': {  
    'CN': {  
      Ids.titleHome: '主页',  
    },  
    'HK': {  
      Ids.titleHome: '主頁',  
    },  
  }  
};  

2.在MyApp initState配置多语言资源(可配置通用或简单多语言资源,二选一)

  void initState() {    
    super.initState();      
//    setLocalizedSimpleValues(localizedSimpleValues);//配置简单多语言资源  
    setLocalizedValues(localizedValues); //配置多语言资源      
  }   

3.在MaterialApp指定localizationsDelegates和supportedLocales:

MaterialApp(  
   home: MyHomePage(),  
   localizationsDelegates: [  
   GlobalMaterialLocalizations.delegate,  
   GlobalWidgetsLocalizations.delegate,  
   CustomLocalizations.delegate //设置本地化代理     
   ],  
   supportedLocales: CustomLocalizations.supportedLocales,//设置支持本地化语言集合     
);  

4.字符串获取

 IntlUtil.getString(context, Ids.titleHome);
 IntlUtil.getString(context, Ids.titleHome, params: [param1, param2]); 
 CustomLocalizations.of(context).getString(Ids.titleHome)

5.其他(不推荐使用)

 //在主页初始化.
 class _MyHomePageState extends State<MyHomePage> {
  Widget build(BuildContext context) {
    CustomLocalizations.init(context);
    ...
  }

 // 字符串获取
 CustomLocalizations.instance.getString(Ids.titleHome)
 extends or with LBaseState()  (MyHomePageState不能使用)
 cl.getString(Ids.titleHome)

6.应用国际化详细使用请参考flutter_wanandroidApp。
Q:Flutter国际化系统切换iOS不生效问题?
A:在Xcode项目Localizations下添加支持语言即可,原文。

Add dependency
dependencies:
  flutter_localizations:
    sdk: flutter  
    
  fluintl: x.x.x  #latest version
APIs
setLocalizedSimpleValues(values)                    : 配置简单多语言资源.
setLocalizedValues(values)                          : 配置多语言资源.
CustomLocalizations.delegate                        : 自定义本地化代理.
CustomLocalizations.supportedLocales                : 本地支持的语言环境.
CustomLocalizations.of(context)                     : 获取CustomLocalizations.
getString(id, {languageCode, countryCode, params})  : 通过id获取字符串,可指定languageCode,countryCode.
IntlUtil.getString(context, id, params)             : 通过id获取字符串,可指定languageCode,countryCode.

//不推荐使用
CustomLocalizations.init(context)                   : 自定义本地化代理初始化.(在MyHomePage初始化)
LBaseState (extends or with LBaseState)             : 可方便简洁获取字符串
cl.getString(id).(MyHomePage不能使用)

所属分类

源码仓库

使用此插件的项目