Pular para o conteúdo
Criação de Apps

Internacionalização de apps (i18n): como preparar para vários idiomas

Resposta rápida

Internacionalização (i18n) é preparar o app para suportar vários idiomas e regiões sem mudar o código a cada tradução. Na prática, você tira os textos do código e guarda em arquivos por idioma, e usa bibliotecas do sistema para datas, números e moedas. A tradução em si é a etapa seguinte, chamada de localização.

Neste artigo
  1. Tire os textos do código
  2. Cuidado com frases montadas aos pedaços
  3. Datas, números e moedas
  4. Espaço e direção do texto
  5. Antes de traduzir

Muito app nasce com textos escritos direto no código: o botão diz "Salvar", o aviso diz "Erro ao enviar". Funciona até alguém pedir a versão em inglês ou espanhol. Aí é preciso caçar cada frase espalhada pelo projeto. Internacionalização, abreviada como i18n, é o trabalho de evitar esse cenário.

Tire os textos do código

O primeiro passo é trocar frases fixas por chaves. Em vez de escrever "Salvar" na tela, o código pede a chave botao_salvar, e um arquivo por idioma diz qual texto ela representa.

  • Arquivo em português: botao_salvar vale "Salvar".
  • Arquivo em inglês: botao_salvar vale "Save".
  • O app escolhe o arquivo conforme o idioma do aparelho ou da conta.

Quase todo framework tem uma biblioteca para isso. O nome e o formato dos arquivos variam, então consulte a documentação da ferramenta que você usa.

Cuidado com frases montadas aos pedaços

Juntar pedaços de texto no código quebra em outros idiomas, porque a ordem das palavras muda. Prefira uma frase completa com espaços reservados para os valores, como "Olá, {nome}! Você tem {quantidade} mensagens". O tradutor consegue reordenar os pedaços como o idioma pedir.

Plurais também pedem atenção. Em português, "1 item" e "2 itens" são duas formas, mas alguns idiomas têm mais variações. As bibliotecas de i18n costumam ter suporte a regras de plural; use esse recurso em vez de um if no meio do código.

Datas, números e moedas

Não monte esses valores na mão. O formato muda por região: 22/11/2026 em uma, 11/22/2026 em outra, vírgula ou ponto como separador decimal. Use as funções de formatação do sistema ou da linguagem, que recebem a região e entregam o formato certo.

Fuso horário merece um cuidado extra: guarde horários em um padrão único no servidor e converta só na hora de mostrar.

Espaço e direção do texto

  • Textos mudam de tamanho. Uma frase em alemão pode ocupar bem mais espaço que em português; deixe botões e menus se adaptarem em vez de fixar a largura.
  • Alguns idiomas, como o árabe e o hebraico, são escritos da direita para a esquerda, o que afeta o layout inteiro. Se esse for um destino possível, pense nisso desde o início.
  • Evite texto dentro de imagens, porque cada idioma exigiria uma imagem nova.

Antes de traduzir

  1. Liste todos os textos que o usuário vê, inclusive e-mails, notificações e mensagens de erro.
  2. Defina um idioma de reserva, usado quando faltar uma tradução.
  3. Teste com um idioma de texto longo para achar telas quebradas.
  4. Peça revisão a alguém que fale o idioma. Tradução automática ajuda no rascunho, mas termos do seu produto pedem conferência humana.

Preparar o app para vários idiomas dá um pouco de trabalho no começo, mas costuma sair bem mais barato do que mexer em cada tela depois.

  • i18n
  • Desenvolvimento
  • Apps

Perguntas frequentes

Qual a diferença entre i18n e l10n?

i18n é preparar o código para suportar vários idiomas. l10n, a localização, é traduzir e adaptar o conteúdo para cada idioma ou região.

Preciso pensar nisso se só vou lançar em português?

Separar os textos desde o início custa pouco e facilita muito o segundo idioma, caso ele apareça. Também ajuda a manter as mensagens organizadas.

Leia também

Criação de Apps

Feature flags: como liberar recursos do app aos poucos e com segurança

Um interruptor no código permite testar com poucos usuários antes de liberar para todos.

· 2 min de leitura
Criação de Apps

Monolito ou microsserviços: qual arquitetura escolher no seu app

Dividir o sistema em muitos serviços resolve alguns problemas e cria outros.

· 2 min de leitura
Criação de Apps

OpenAPI: como documentar uma API e por que isso evita retrabalho

Documentar a API num arquivo padrão economiza conversa entre quem cria e quem consome.

· 2 min de leitura
Criação de Apps

Code review: como revisar código com pull request sem atrasar o time

Revisar código em pull request é menos sobre achar culpados e mais sobre evitar erros antes de publicar.

· 3 min de leitura

Deixe seu comentário