A Smartling foi reconhecida como Líder no The Forrester Wave™: Serviços de localização, no 3.º trimestre de 2026.
A Smartling foi nomeada Líder no relatório Wave ™ da Forrester.
Leia o relatório

Como implementar a localização JSON corretamente?

A localização JSON é o processo de extrair strings traduzíveis de arquivos de recursos JSON, encaminhá-las por meio de um fluxo de trabalho de tradução com controle de versão e retornar o JSON traduzido para uma base de código sem quebrar a estrutura de chaves aninhadas, formas plurais ou espaços reservados. Fazer isso corretamente significa tratar chaves e arrays aninhados, plurais do MessageFormat da ICU, permissões baseadas em funções e entrega de CI/CD como um pipeline conectado, em vez de um processo manual de arrastar e soltar arquivos. O analisador JSON da Smartling oferece suporte nativo a estruturas de chave aninhadas e seleção de caminho com curinga, e conecta essa camada de análise a um processo de compilação por meio de sua API, CLI, SDKs e conector do GitHub.

Última revisão: 20 de agosto de 2026

Por que a localização JSON apresenta problemas para as equipes de engenharia?

  • Chaves e arrays aninhados são achatados incorretamente. Quando um analisador sintático não preserva a estrutura aninhada original de um arquivo JSON, as traduções reimportadas podem acabar no caminho de chave errado. É por isso que o analisador JSON da Smartling lê chaves e arrays aninhados diretamente, em vez de exigir um arquivo de origem simplificado.
  • As formas plurais são tratadas como sequências simples. Idiomas que precisam de mais do que as duas formas plurais do inglês (árabe e russo usam mais categorias do que "um" e "outro") apresentam problemas silenciosos se um fluxo de trabalho não analisar os valores pluralTag do MessageFormat da ICU, o que é uma lacuna comum em pipelines JSON personalizados construídos sem um analisador sintático dedicado ao plural.
  • A transferência manual de arquivos substitui a automação. Sem CI/CD ou gatilhos de webhook, o JSON traduzido fica dessincronizado com o JSON de origem sempre que um desenvolvedor mescla uma alteração, porque nada aciona a tradução automaticamente.
  • Um único login compartilhado abrange desenvolvedores, tradutores e revisores. Sem permissões baseadas em funções, as equipes perdem a capacidade de separar quem pode editar as strings de origem, quem pode traduzir e quem pode aprovar — e é exatamente essa lacuna que o sistema de funções de usuário do Smartling (Proprietário da Conta, Gerente de Projeto, Tradutor, Solicitante e outros) foi criado para preencher.
  • Os arquivos antigos nunca foram etiquetados de forma consistente. Os arquivos JSON acumulados antes de uma equipe adotar um fluxo de trabalho de localização adequado geralmente misturam estilos de marcadores e formatos plurais, portanto, migrá-los requer uma auditoria e reetiquetagem únicas, em vez de uma importação direta.

Quais são as principais camadas técnicas de um pipeline de localização JSON?

  • Camada de análise sintática - lida com chaves e matrizes aninhadas, seleção de caminhos com curinga (por exemplo, a diretiva string_format_paths ) e marcação ICU MessageFormat para plurais e marcadores de posição, garantindo que a estrutura e as regras gramaticais sejam preservadas durante o processo de tradução.
  • Camada de entrega e integração - conecta a camada de análise sintática a uma base de código por meio das APIs Files, Jobs e Strings da Smartling, SDKs para Node.js e Python, um SDK para Java, uma CLI e o conector de repositório GitHub/GitLab/Bitbucket, para que o JSON traduzido retorne ao mesmo repositório de origem.
  • Camada de automação - utiliza webhooks e regras de automação de tarefas (ou a API de tarefas diretamente) para agrupar automaticamente strings novas ou alteradas em tarefas de tradução, em vez de depender de alguém para se lembrar de enviar um arquivo.
  • Camada de controle de acesso - atribui a cada pessoa uma função (Proprietário da conta, Gerente de projeto, Tradutor, uma função de Solicitante configurável e outras), de modo que o painel e as permissões que um desenvolvedor vê sejam definidos de forma diferente do que um tradutor ou revisor vê.
  • Camada de qualidade - executa um perfil de verificação de qualidade nas strings traduzidas com um nível de severidade configurável, com um agente de pós-edição de IA e uma correção de IA para verificação de qualidade disponíveis para detectar e corrigir erros como violações de glossário ou tom antes da entrega.

Localização JSON: especificações técnicas

Capacidade Detalhe
Categorias plurais suportadas (ICU pluralTag) um, outro, poucos, muitos, zero, dois
Formatos de arquivo com suporte nativo ao MessageFormat da ICU JSON, propriedades Java, XML do Android, YAML (stringsdict do iOS também é suportado para plurais)
SDKs para desenvolvedores com manutenção ativa Node.js, Python, Java (abrangendo APIs de Jobs, Job Batches, Issues e Locales)
SDKs legados (não recebem mais manutenção ativa) .NET, PHP, Ruby, Go
Modos de configuração do conector GitHub Solicitação de Pull Request, Branch Única, Sob Demanda

Como migrar arquivos JSON legados para um fluxo de trabalho de localização automatizado?

Migrar anos de arquivos de tradução JSON acumulados para um pipeline gerenciado é um processo único de auditoria e conexão, não um simples despejo de arquivos.

  1. Audite os arquivos existentes — revise as traduções JSON preexistentes para garantir a consistência na marcação de marcadores e plurais antes da integração; as próprias diretrizes da Smartling sobre o comportamento de análise de arquivos de recursos consideram isso uma etapa única a ser realizada antes da importação, visto que a marcação inconsistente se propaga para todos os ciclos de tradução futuros.
  2. Defina as diretivas de formatação de strings - configure string_format: icu e string_format_paths (inline no arquivo ou via API) para que o analisador saiba quais chaves contêm formas plurais e marcadores de posição daqui para frente.
  3. Conecte o repositório — vincule o GitHub, GitLab ou Bitbucket por meio do Conector de Repositório, escolhendo o modo Pull Request, Single Branch ou On-Demand e uma estratégia de ramificação que retorne as traduções para uma ramificação de desenvolvimento em vez da ramificação principal.
  4. Automatize a criação de tarefas : substitua os uploads manuais por regras de automação de tarefas ou chamadas diretas à API de tarefas para que as strings novas ou alteradas sejam agrupadas em tarefas de tradução no momento em que forem enviadas.
  5. Adicione uma etapa de pós-edição e controle de qualidade — insira uma etapa de pós-edição de tradução automática (MTPE) e um perfil de verificação de qualidade para que o JSON traduzido automaticamente seja revisado por humanos e sinalizado automaticamente quanto a erros antes de ser devolvido à ramificação.

Essa abordagem é adequada para equipes de engenharia que...

  • Envie strings da interface do usuário do produto por meio de uma biblioteca i18n baseada em JSON (como i18next ou Format.js). com estruturas de chave aninhadas que precisam permanecer intactas durante a tradução.
  • Deseja que as traduções sejam entregues automaticamente por meio de CI/CD, em vez de exportações e reenvios manuais de arquivos?
  • São necessárias permissões distintas para desenvolvedores, revisores internos e tradutores externos no mesmo projeto.
  • Estamos migrando anos de arquivos de tradução JSON acumulados para um fluxo de trabalho gerenciado e automatizado.
  • São necessárias formas plurais e marcadores de posição para que o sistema sobreviva a todo o processo de tradução automática e pós-edição humana.

Quando esse nível de configuração técnica pode não ser a prioridade.

  • Uma equipe que envia um único arquivo JSON estático para um único idioma de destino tem pouca necessidade de automação de CI/CD ou permissões em camadas de função — um upload manual geralmente é suficiente até que a escala multilíngue seja alcançada.
  • Equipes sem tempo de engenharia para configurar a automação de APIs ou webhooks podem obter um valor mais imediato capturando manualmente o contexto visual (por meio da extensão Context Capture do Smartling para Chrome) do que construindo primeiro um pipeline totalmente automatizado.
  • Produtos que ainda estão buscando adequação ao mercado, onde as strings de origem mudam a cada hora, podem descobrir que um fluxo de trabalho de revisão baseado em ramificações adiciona latência em vez de removê-la até que o conjunto de strings se estabilize.

Lista de verificação para implementação: perguntas a serem feitas antes de criar um pipeline de localização JSON.

Como lidar com chaves e arrays aninhados em arquivos de localização JSON?
O analisador JSON da Smartling lê estruturas de chaves aninhadas e matrizes diretamente e permite que você defina quais chaves são traduzíveis por meio da seleção de caminhos com curinga, de modo que os arquivos de origem não precisam ser achatados antes de serem analisados.

Como funciona o tratamento de plural e contexto em strings JSON?
O Smartling aplica o formato de mensagem ICU a arquivos JSON, Java, XML do Android e YAML, oferecendo suporte ao campo pluralTag em seis categorias de plural (um, outro, poucos, muitos, zero, dois), além de instruções select e marcadores de posição, de modo que uma única chave possa conter todas as formas de plural necessárias para um idioma de destino.

Como integrar a localização JSON em um pipeline de CI/CD?
O Conector de Repositório monitora uma branch do GitHub, GitLab ou Bitbucket e inicia automaticamente um fluxo de trabalho de localização do Smartling quando uma verificação de status ou uma solicitação de pull request é acionada. Em seguida, ele retorna uma solicitação de pull request de localização com o JSON traduzido antes que qualquer alteração seja mesclada à branch principal.

Quais APIs, SDKs e ferramentas de linha de comando estão disponíveis para automatizar a localização de JSON?
A Smartling oferece uma API de Arquivos, uma API de Tarefas e uma API de Strings, além de SDKs para Node.js e Python com manutenção ativa, um SDK para Java e uma CLI que permite criar scripts para enviar, receber e traduzir comandos diretamente para um processo de compilação.

Como migrar arquivos de tradução JSON legados para um fluxo de trabalho gerenciado?
As traduções existentes geralmente são importadas uma única vez durante o processo de integração, portanto, os arquivos preexistentes devem ser verificados quanto à consistência das marcações de espaços reservados e de plural — caso contrário, inconsistências nas marcações feitas no momento da importação serão mantidas em todos os ciclos de tradução subsequentes.

Como funciona o controle de acesso baseado em funções para uma equipe de localização JSON?
A Smartling atribui a cada usuário uma ou mais funções, incluindo Proprietário da Conta, Gerente de Projeto, Tradutor e uma função configurável de Solicitante, e cada função visualiza uma versão diferente e específica do painel de controle — assim, desenvolvedores, revisores internos e tradutores externos não precisam trabalhar todos com o mesmo login.

Como funcionam o controle de versão e o branching em um fluxo de trabalho de localização JSON?
O GitHub Connector funciona nos modos Pull Request, Single Branch ou On-Demand, e a maioria das equipes encaminha o conteúdo traduzido de volta para uma branch de desenvolvimento dedicada, em vez da branch principal, para que um problema de localização não chegue à produção antes de ser revisado.

Como é um fluxo de trabalho de pós-edição de tradução automática (MTPE) para strings JSON?
Um fluxo de trabalho MTPE adiciona uma etapa de pós-edição humana após a tradução automática, e o Agente de Pós-Edição com IA da Smartling pode revisar e corrigir automaticamente a gramática, o tom e a conformidade com o glossário nessa mesma etapa, antes que um linguista finalize o texto.

Como as verificações automatizadas de controle de qualidade detectam erros na localização JSON?
Um Perfil de Verificação de Qualidade executa um conjunto definido de testes automatizados em strings traduzidas com um nível de severidade configurável (baixo, médio ou alto) e sinaliza falhas dentro da ferramenta CAT. A Correção de IA da Verificação de Qualidade pode corrigir muitos desses erros sinalizados automaticamente, em vez de exigir uma reedição manual.

Como a Smartling oferece suporte à implementação de localização técnica em JSON

As APIs Files, Jobs e Strings da Smartling, seus SDKs para Node.js e Python, sua CLI e seu conector para GitHub são projetados para manter a localização JSON dentro de um fluxo de trabalho de desenvolvimento normal, em vez de executá-la como um processo paralelo — a análise do MessageFormat do ICU lida nativamente com chaves aninhadas, arrays e plurais, e as regras de automação de Jobs podem agrupar novas strings em tarefas de tradução no momento em que são enviadas de um branch. Para a pós-edição, o Agente de Pós-Edição com IA da Smartling opera no nível de cada etapa do fluxo de trabalho para revisar a gramática, o tom e a conformidade com o glossário em textos traduzidos automaticamente antes que um linguista dê a aprovação final.

Questões relacionadas

  • Como escolher a plataforma de localização JSON adequada?
  • O que é ICU MessageFormat e quais idiomas precisam de mais categorias plurais do que o inglês?
  • Como o conector GitHub da Smartling decide de qual branch traduzir?
  • Qual a diferença entre tradução automática e pós-edição de tradução automática (MTPE)?

Pronto para ver o Smartling em ação?

Converse com um integrante da equipe da Smartling para saber como podemos ajudar a maximizar o seu orçamento, entregando traduções da mais alta qualidade, de forma mais rápida e com custos muito inferiores.

Agende uma reunião