패키지, 저장소 및 앱 카테고리 검색

fluintl 표지
패키지 상세v2.0.0

fluintl

Flutter 국제화 지원 패키지입니다. 빠르게 국제화 앱을 만들 수 있습니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
202
좋아요
3
Pub 점수
150

패키지 설치

flutter pub add fluintl

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

fluintl은 앱에서 국제화를 간소화하기 위해 설계된 Flutter 패키지로, 개발자가 빠르게 다국어 지원을 구현할 수 있도록 도와줍니다. 번역 관리, 로케일 변경 처리 및 동적 콘텐츠 지원을 위한 사용하기 쉬운 API를 제공합니다. 언어 파일을 로드하고 런타임 중에 언어를 전환할 수 있는 내장 도구를 통해 글로벌 접근이 가능한 애플리케이션을 구축하는 과정을 간소화합니다. Flutter의 위젯 트리와 원활하게 통합되며 Android, iOS, Web, macOS, Windows, Linux 등 모든 주요 플랫폼을 지원합니다.

사용 사례

  • 다국어 모바일 및 웹 애플리케이션 구축
  • 동적 언어 전환 지원
  • 앱 번역을 효율적으로 관리하기
  • 기존 Flutter 프로젝트에 로컬라이제이션 통합하기
  • 사용자 친화적인 국제화된 UI 만들기

주요 기능

  • 간편한 번역 파일 관리
  • 런타임 로케일 전환
  • 복수형 및 성별 형식 지원
  • 내장된 백업 메커니즘
  • Flutter 위젯과의 원활한 통합

적합한 대상

  • 글로벌 앱을 개발하는 개발자
  • 다중 언어 리소스를 관리하는 팀
  • 빠른 i18n 설정이 필요한 프로젝트
  • 다양한 지역 청중을 겨냥한 앱
  • 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不能使用)

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트