리액트 네이티브 앱 현지화하기
CLI로 기존 JSON 메시지 카탈로그를 번역하고, 생성된 언어 파일을 리액트 네이티브 앱에서 불러오세요.
리액트 네이티브 앱에서는 react-i18next와 JSON 번역 파일을 함께 사용할 수 있습니다. Lingo.dev는 설정된 로컬라이제이션 엔진으로 파일을 번역하고, 기존 메시지 라이브러리는 로캘 선택과 메시지 표시를 담당합니다.
이 워크플로는 메시지 키가 있는 기존 카탈로그에서 시작합니다. 메시지 키, 보간 구문, 복수형 규칙, 런타임 설정은 그대로 유지하세요.
원본 카탈로그 설정하기 #
원본이 src/locales/en.json에 있다면 프로젝트 루트에서 CLI를 초기화하세요.
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr,de,ja --files 'src/locales/en.json' --yes
lingo link생성된 .lingo/config.json의 구조는 다음과 같습니다. 연결 과정에서 생성된 실제 조직 및 엔진 식별자는 그대로 유지하세요.
{
"orgId": "org_...",
"engineId": "eng_...",
"sourceLocale": "en",
"targetLocales": ["es", "fr", "de", "ja"],
"files": [{ "pattern": "src/locales/en.json" }]
}CLI는 확장자로 JSON 형식을 감지하고 src/locales/es.json와 같은 대상 경로를 결정합니다. 원본 카탈로그만 선택하세요. 생성된 대상 파일을 원본으로 추가하면 안 됩니다. 앱에서 여러 파일을 사용한다면 원본 네임스페이스마다 항목을 추가하세요.
메시지 번역하고 불러오기 #
아직 없는 대상 파일을 생성하세요.
lingo push --backfill-missing --wait완료되면 생성된 JSON을 확인하세요. 앱의 기존 리소스 가져오기 구문이나 로더에 대상 카탈로그를 추가하고, react-i18next에서 사용하는 언어와 네임스페이스에 맞게 등록하세요. 런타임 설정과 CLI의 targetLocales에 지정된 지원 언어는 일치해야 합니다.
기기나 에뮬레이터에서 대상 언어로 화면을 여세요. 레이블, 보간된 값, 앱의 복수형이 제대로 표시되는지 테스트하세요. 대상 카탈로그 대신 원본 언어가 대체 언어로 표시되는 일이 없는지 확인하세요.
이후 원본 변경 사항 동기화하기 #
설정, 원본, 승인된 대상 파일, .lingo/lock.json를 함께 커밋하세요. 원본 메시지를 수정한 후 다음을 실행하세요.
lingo push --wait변경된 카탈로그를 검토하고 출시 전에 화면을 다시 확인하세요. 자동화하려면 GitHub App 또는 지속적 통합 워크플로를 사용하세요. 파일 처리 방식과 가져오기에 관한 내용은 JSON 형식 제어와 검토된 번역 보존하기에서 확인할 수 있습니다.