현지화
우선순위: P1 (표준)
easy_localization을 사용한 일관된 다국어 지원입니다.
형식 선택
- **CSV (번역가가 있는 팀에 권장):
- 비기술적 편집자가 쉽게 업데이트 가능
sheet_loader_localization을 통한 Google Sheets 기본 호환성assets/langs/에 저장 (일반적인 규칙)
- **JSON (개발자 친화적):
- 중첩 구조 지원 (예:
items_count.zero) - IDE 검증 및 자동 완성
assets/translations/에 저장
- 중첩 구조 지원 (예:
두 형식 모두 easy_localization에서 동일하게 작동합니다.
구조
# CSV 형식 (Google Sheets 워크플로우)
assets/langs/langs.csv
# 또는 JSON 형식 (중첩 키)
assets/translations/
├── en.json
└── vi.json
구현 지침
- 부트스트랩: 루트를
EasyLocalization으로 감쌉니다. 항상await EasyLocalization.ensureInitialized()를 사용하세요. - 조회: 문자열에
.tr()확장을 사용합니다 (예:'welcome'.tr()). - 로케일:
context.setLocale(Locale('code'))를 통해 변경합니다. - 파라미터:
{}플레이스홀더를 사용하고tr(args: [...])로 전달합니다. - 수량: 수량에는
plural()을 사용합니다. - 시트 동기화:
sheet_loader_localization을 사용하여 Google Sheets에서 CSV/JSON을 자동 생성합니다.
안티 패턴
- 하드코딩: UI에 원시 문자열을 사용하지 말고 키를 사용하세요.
- 수동 현지화: 표준
Localizations.of를 피하고 GetX 또는easy_localization컨텍스트 메서드를 사용하세요. - 불일치: 모든 로케일 파일에서 키를 동일하게 유지하세요.
참조 및 예제
설정 및 Google Sheets 자동화에 대한 자세한 내용은: references/REFERENCE.md를 참조하세요.
관련 주제
idiomatic-flutter | widgets