← Conceitos

Adicionando um idioma

Não há pacote de idioma para escrever, extrair ou distribuir. Um idioma é uma configuração do projeto: adicione-o em Idiomas no painel, e o SDK busca seu catálogo da mesma forma que busca todos os outros.

Um idioma é uma configuração do projeto

O locale store aceita qualquer código de localidade. Defina-o como um idioma que o projeto ainda não tem e nada quebra: todas as frases voltam ao texto de origem, porque a frase de origem é sempre o fallback. Adicione o idioma ao projeto e a próxima busca traz o catálogo real. Sem build, sem deploy.

// 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.

Adicionando um idioma a um projeto em produção

Escolha o idioma em Locales e salve. O que acontece com as frases que já estão no catálogo é definido pela política do projeto quando um idioma é adicionado: traduzi-las imediatamente ou perguntar antes. Quando ela pergunta, a caixa de diálogo calcula o custo exato do catálogo existente, por palavra, antes de qualquer gasto. Diga sim e, instantes depois, o painel mostra o novo idioma com cobertura total; o Manager guarda um rascunho de máquina por frase, cada um com o selo do modelo até que uma pessoa o edite.

A partir daí, o novo idioma é como qualquer outro idioma de destino: uma frase que for registrada amanhã é traduzida automaticamente para ele assim que chegar.

Como atualizar um idioma que ficou para trás

Um idioma pode ficar defasado em relação ao catálogo — a tradução automática esteve desativada por um tempo, ou um lote de frases chegou mais rápido do que um tradutor conseguiu processar. O painel mostra quantas frases faltam em cada idioma, e a ação AI Translate Pending do Manager preenche a lacuna de uma só vez: para o idioma que você está com aberto ou para o projeto inteiro. A confirmação em nível de projeto lista todos os idiomas de destino que serão afetados e avisa que a tradução por IA tem um custo por palavra por idioma.

Adicionar um idioma é a única coisa nesta trilha que acontece no painel e não no código, e é justamente essa a ideia. Quem é responsável pelo conteúdo decide quais idiomas existem; o app apenas os exibe.