← 개념

로케일 추가하기

작성하고, 추출하고, 배포해야 하는 로캘 번들은 없습니다. 언어는 프로젝트 설정입니다. 대시보드의 로캘에서 언어를 추가하면, SDK가 다른 언어의 카탈로그와 똑같은 방식으로 해당 카탈로그를 가져옵니다.

언어는 프로젝트 설정입니다

로케일 스토어는 어떤 로케일 코드든 받습니다. 프로젝트에 아직 없는 언어로 설정해도 문제없이 동작하며, 모든 문구는 원문 텍스트로 대체됩니다. 원문은 항상 폴백이기 때문입니다. 프로젝트에 해당 언어를 추가하면 다음 가져오기 때 실제 카탈로그가 적용됩니다. 빌드도, 배포도 필요 없습니다.

// Nothing in the app changes — the switcher just gains a pill.
locale.set('de-DE');

// Before German is a target locale of the project: every phrase falls back to
// its source text. After: the German catalog, fetched like any other locale.

운영 중인 프로젝트에 언어 추가하기

로캘에서 언어를 선택하고 저장하세요. 카탈로그에 이미 있는 문구가 어떻게 처리되는지는 프로젝트의 언어 추가 시 정책에 따라 달라집니다. 바로 번역하거나, 먼저 확인을 요청할 수 있습니다. 확인을 요청하는 경우, 비용이 발생하기 전에 대화 상자에서 기존 카탈로그의 비용을 단어 단위로 정확하게 계산해 보여 줍니다. 승인하면 잠시 후 대시보드에서 새 언어가 100% 적용된 상태로 표시됩니다. 매니저에는 문구마다 기계 번역 초안이 하나씩 저장되며, 사람이 수정하기 전까지 각 초안에는 모델 배지가 붙어 있습니다.

그 이후로 새 언어는 다른 모든 대상 로케일과 동일하게 취급됩니다. 내일 등록되는 문구는 도착하는 즉시 해당 언어로 기계 번역됩니다.

뒤처진 언어 따라잡기

로캘이 카탈로그에 미치지 못할 수 있습니다. 한동안 자동 번역이 꺼져 있었거나, 번역기가 처리하는 속도보다 문구가 더 빠르게 들어왔을 때 그렇습니다. 대시보드에서 언어별로 누락된 문구 수를 확인할 수 있으며, 매니저의 AI Translate Pending 작업으로 한 번에 빈틈을 채울 수 있습니다. 현재 열어 둔 로캘만 또는 프로젝트 전체를 대상으로 실행할 수 있습니다. 프로젝트 전체 확인 창에는 처리될 모든 대상 로캘이 표시되고, AI 번역에는 로캘별 단어당 비용이 발생한다는 경고가 나타납니다.

언어 추가는 이 트랙에서 코드가 아닌 대시보드에서 이루어지는 유일한 작업이며, 바로 그 점이 핵심입니다. 어떤 언어를 지원할지는 문구를 관리하는 사람들이 결정하고, 앱은 그저 그 언어를 표시할 뿐입니다.