Ir para o conteúdo principal

Fluxo de Trabalho da Aplicação

Tradução Beta Não Oficial

Esta página foi traduzida por PageTurner AI (beta). Não é oficialmente endossada pelo projeto. Encontrou um erro? Reportar problema →

Embora nosso guia de Instalação ajude você a começar, este documento oferece uma visão geral de como seu fluxo diário de tradução pode funcionar.

Existem dois tipos de ferramentas e serviços de tradução:

  • Ferramentas que funcionam localmente no seu computador - como sua IDE.

  • Serviços de tradução em nuvem que exigem upload dos seus arquivos de tradução. Eles requerem um pipeline de tradução com fluxo complexo.

Este guia mostrará como trabalhar com ambos os tipos de ferramentas.

Fluxo de trabalho simples com ferramenta de tradução local​

projectRoot
|-- src
|   |-- App.js
|-- extracted
|   |-- en.json
|-- lang
|   |-- fr.json
|   |-- de.json
|-- package.json
|-- .eslintrc.js

Os arquivos de tradução extraídos ficam na pasta extracted pois possuem estrutura interna diferente (ex: contêm informações adicionais como comentários). Os arquivos gerados durante a tradução são armazenados na pasta lang.

O fluxo operacional​

O processo segue esta sequência:

Fluxo

  1. Extração: Esta etapa agrega todas as defaultMessages da aplicação em um único arquivo JSON com description, pronto para tradução.

  2. Edição: Edite as traduções e salve ao concluir.

  3. As alterações aparecem imediatamente na sua build

Fluxo de trabalho complexo com serviço de tradução em nuvem​

Estrutura do Projeto​

Um projeto minimalista compatível com i18n pode ter esta estrutura:

projectRoot
|-- src
|   |-- App.js
|-- lang
|   |-- en-US.json
|   |-- fr.json
|-- package.json
|-- .eslintrc.js

onde a pasta lang armazena o arquivo consolidado de strings da aplicação. Integrações com fornecedores de tradução externos podem consumir en-US.json e produzir fr.json ou outros arquivos de localidade conforme configurado.

Pipeline​

Um pipeline de tradução genérico segue este modelo:

Pipeline

  1. Extração: Esta etapa agrega todas as defaultMessages da aplicação em um único arquivo JSON com description, pronto para tradução.

  2. Upload de mensagens: Envia o arquivo JSON para o fornecedor de tradução.

  3. Download de traduções: Consulta periodicamente o fornecedor ou integra-se a ele para baixar mensagens traduzidas nos idiomas configurados.

  4. Commit: Registra as traduções no código fonte.

Papel do FormatJS neste contexto​

O objetivo deste projeto não é fornecer uma solução completa para o pipeline, mas focar na Experiência do Desenvolvedor através de ferramentas e melhores práticas para conscientização sobre i18n. Isso inclui:

  1. Declaração de mensagens compatíveis com i18n

  2. Linter que impõe tais mensagens

  3. CLI para extração e compilação

  4. Polyfills para ambientes de runtime i18n estáveis

  5. Plugin de bundler para compilar TypeScript/JavaScript