搜尋套件、儲存庫與 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不能使用)

所屬分類

原始碼儲存庫

使用此套件的專案