Localização em CI/CD: traduza a cada commit

Adicione tradução ao seu pipeline de CI/CD com a PTC: um token, um arquivo de fluxo de trabalho e os arquivos traduzidos retornam como um pull request no GitHub, GitLab ou Bitbucket.

Em resumo: quatro passos

1. Crie um projeto na PTC e escolha a integração via API. Você descreve o produto, escolhe os idiomas e obtém um token de API do projeto.
2. Adicione o token ao seu repositório como o secret PTC_API_TOKEN.
3. Adicione o fluxo de trabalho pronto para o seu CI. Veja os exemplos para GitHub Actions e GitLab CI.
4. Faça o push. A PTC traduz apenas as strings novas e alteradas, e os arquivos traduzidos voltam como um pull request.

A configuração completa está abaixo. Você configura isso uma vez; depois disso, cada commit é traduzido sem que ninguém precise iniciá-lo.

Os arquivos de origem mudam, a PTC traduz automaticamente, os arquivos traduzidos retornam ao seu repositório como um merge request, e o AI Visual QA verifica o aplicativo renderizado antes do lançamento ser enviado. Sem vaivém de arquivos entre equipes, sem transferências para agências entre os lançamentos.

O fluxo de trabalho de localização que está atrasando sua equipe

A maioria das equipes de engenharia adota a localização da mesma maneira. Elas enfrentam os mesmos três problemas:

• As traduções quebram a UI. Palavras em alemão são cerca de 30% mais longas que em inglês. Você só descobre o estouro dos seus botões em produção.
• A localização é sempre a última etapa. Você exporta manualmente arquivos .json, .po ou .strings. As traduções voltam tarde e atrasam seu lançamento.
• As traduções não refletem sua marca. Ferramentas genéricas de tradução de software não conhecem os nomes dos seus recursos, sua terminologia técnica ou se o seu tom é formal ou descontraído.

A PTC substitui todos os três por um fluxo nativo de CI.

O que destaca a PTC na localização de software

Cada item abaixo leva à seção detalhada mais adiante na página.

• A PTC aprende o vocabulário e a voz da marca do seu produto - traduções sob medida por projeto, com precisão e traduções sensíveis ao contexto em cada arquivo de recursos.
• Revisão visual de tradução do seu software em execução - a PTC revisa seu aplicativo renderizado para que você faça o lançamento sem QA manual por idioma.
• Integração nativa de CI/CD com GitHub, GitLab e Bitbucket - um push que adiciona ou altera strings de origem volta como um merge request.
• Glossário e memória de tradução por projeto - a terminologia permanece consistente em cada arquivo de recursos no projeto e em cada lançamento.
• Todos os formatos comuns de recursos suportados sem configuração extra - JSON, YAML, PO, .strings, .xcstrings, .properties, XLIFF, CSV e mais.

A PTC aprende o vocabulário e a voz da marca do seu produto

A PTC não é uma ferramenta de tradução que ajuda sua equipe a traduzir. A PTC é o tradutor. Ela aprende o vocabulário, o tom e as regras do seu produto a partir das strings que você envia, e os aplica de forma consistente em cada lançamento.

Construída para equipes de desenvolvimento, não adaptada depois

Uma ferramenta de tradução de software conquista seu espaço quando se ajusta ao fluxo de trabalho existente, entende formatos de arquivos técnicos e preserva placeholders e variáveis. A PTC foi construída exatamente para isso: ela analisa seus arquivos de recursos automaticamente, aprende a terminologia do seu produto e entrega traduções que respeitam as restrições da sua UI, para que seus engenheiros mantenham o fluxo de trabalho deles em vez de se adaptarem a um aplicativo de tradução genérico.

• Voz da marca por projeto. Defina o propósito e o público do seu produto uma vez. A PTC usa esse contexto para cada string, para que suas traduções soem como se tivessem sido escritas pela sua equipe. Isso vale quer seu produto seja formal ou casual, técnico ou voltado para o consumidor final.
• Glossário que acumula valor. Adicione termos específicos da marca, nomes de recursos e regras de “não traduzir” uma vez. “Cart = Carrito” para o espanhol. A PTC os aplica em cada arquivo, cada idioma, cada atualização futura.
• Traduções que se ajustam à sua UI. A PTC usa padrões inteligentes de comprimento para cada idioma de destino e sinaliza os estouros enquanto você traduz, não depois do build.
• Placeholders tratados corretamente. A PTC reconhece placeholders como %s, {{name}}, {0} e %1$s em todos os formatos de recursos suportados. As variáveis são preservadas para que você nunca lance uma string quebrada.
• Memória de tradução entre atualizações. Quando você altera uma palavra em um parágrafo, a PTC retraduz apenas o que mudou e preserva o resto.
• Sem adivinhação. Se uma string for ambígua (“Submit” é um botão ou um substantivo?), a PTC para e pergunta em vez de escolher um significado errado.

Revisão visual de tradução do seu software em execução - faça lançamentos sem QA manual por idioma

A tradução é necessária, mas não suficiente para lançar um software multilíngue. Uma string traduzida pode resultar no lançamento de um produto quebrado. Um rótulo em alemão que causa estouro em um botão. Uma palavra em francês com a classe gramatical errada. Uma string em inglês que alguém esqueceu de envolver no auxiliar de i18n. Detectar esses problemas tradicionalmente significa uma execução de QA manual de vários dias por idioma a cada lançamento. Essa é a etapa mais cara e lenta da localização, e o motivo pelo qual muitas equipes se limitam a dois ou três idiomas.

O AI Visual QA da PTC substitui essa execução por uma automação nativa de CI. Duas variantes cobrem todos os tipos de software:

• Extensão do navegador (para softwares baseados em navegador, como SaaS, UIs de administração web, aplicativos de desktop baseados na web). Instale a extensão do navegador da PTC e grave um percurso gravado dos fluxos de usuário críticos do seu aplicativo uma vez. A partir de então, a PTC reproduz a gravação após cada lançamento, captura cada tela em cada idioma e inspeciona o resultado renderizado.
• Upload de captura de tela (para aplicativos de desktop nativos, ferramentas de CLI de servidor ou qualquer software fora do navegador). Faça o upload de uma captura de tela por idioma por tela. A IA de visão da PTC inspeciona o resultado renderizado da mesma maneira.

Os problemas que a PTC pode corrigir nos arquivos de recursos (ambiguidade entre verbo/substantivo, estouro de layout, incompatibilidades de plural) são corrigidos automaticamente. Os problemas que residem no seu código-fonte (wrappers ausentes, strings hardcoded, concatenação de frases) voltam como prompts prontos para colar para o Cursor ou Claude Code.

A entrega muda de “arquivos de recursos traduzidos” para “software multilíngue pronto para lançamento”. Nenhuma outra plataforma de localização oferece isso hoje.

Integração nativa de CI/CD com GitHub, GitLab e Bitbucket

Faça o commit de um .ptc-config.yml nomeando os arquivos que contêm suas strings de origem e onde as traduções devem ficar:

# .ptc-config.yml
source_locale: en
files:
  - file: src/locales/en.json
    output: src/locales/{{lang}}.json
  - file: app/src/main/res/values/strings.xml
    output: app/src/main/res/values-{{lang}}/strings.xml

Em seguida, adicione a PTC Translate action ao seu fluxo de trabalho. Ela carrega uma versão fixada da PTC CLI dentro de si, para que seu build não baixe nada no momento da execução:

# .github/workflows/translate.yml
name: Translate
on:
  push:
    branches: [main]
    paths:
      - 'src/locales/en.json'
      - 'app/src/main/res/values/strings.xml'
  workflow_dispatch: {}

jobs:
  translate:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: OnTheGoSystems/ptc-action@v1
        with:
          api-token: ${{ secrets.PTC_API_TOKEN }}
          create-pr: true

A PTC sincroniza as novas strings de origem, traduz-as para seus idiomas de destino e abre um pull request com os arquivos es.json, de.json, values-es/strings.xml atualizados, e assim por diante. Sua equipe o revisa como qualquer outra alteração de código. Um push que deixa suas strings de origem inalteradas não traduz nada e não abre nada.

Para GitLab CI, Bitbucket Pipelines, CircleCI ou qualquer outro sistema de CI, o mesmo fluxo funciona via REST. Veja a referência da API da PTC para a API completa de webhook e sincronização.

Para equipes que fazem vários lançamentos por semana, a PTC escala sem sobrecarga por lançamento. A PTC apenas retraduz as strings que realmente mudaram. Uma atualização de 10 strings não retraduz as outras 10.000. A PTC funciona 24 horas por dia, 7 dias por semana. Você nunca espera pela estimativa de entrega da próxima semana de uma agência.

A localização ocorre junto com seu código, não depois dele

A localização contínua significa que a tradução vive dentro do seu ciclo de vida de desenvolvimento em vez de se tornar uma etapa separada no final. A PTC entrega isso conectando-se ao seu repositório Git ou pipeline de CI/CD. Quando você faz o push de um novo código, a PTC detecta as novas strings, aplica o contexto e o glossário do seu produto, traduz-as e as retorna como um merge request, para que a localização acompanhe cada commit em vez de bloquear o próximo lançamento.

Como funciona a integração de CI/CD

Antes de configurar a PTC com seu sistema de CI, aqui estão os três princípios por trás da API e CLI da PTC:

1. Os arquivos de recursos estão vinculados a um branch

Cada arquivo que você envia para a PTC está vinculado a um nome de branch (ex.: main, feature/new-checkout). Isso mantém as traduções separadas, para que as traduções de recursos diferentes não sobrescrevam umas às outras. Quando você usa as configurações prontas de CI/CD, esse mapeamento já é tratado automaticamente.

2. As traduções são processadas de forma assíncrona

A PTC não retorna as traduções imediatamente. Em vez disso, ela:

• Faz o upload dos arquivos atualizados
• Identifica apenas as strings novas ou modificadas
• Traduz as strings
• Prepara os arquivos traduzidos para download

3. Um único script de CLI funciona em qualquer lugar

Em vez de chamar a API você mesmo, use a PTC CLI:

Um script lida com todo o fluxo (upload → consulta periódica → download). A CLI é executada em Linux e macOS, e funciona com GitHub Actions, GitLab, Bitbucket ou qualquer outra plataforma de CI/CD.

Fluxo de alto nível: configure a API da PTC no seu pipeline de CI/CD

1Inscreva-se para um teste.

Tenha acesso total a todos os recursos e traduza até 20.000 palavras para quaisquer dois idiomas que você escolher.

2Crie um novo projeto.

Ao escolher como usar a PTC, selecione integração via API. Durante a configuração, você fornecerá um pouco de contexto sobre o seu projeto (o que ele faz, para quem é) e selecionará os idiomas para os quais deseja traduzir.

3Obtenha seu token de API.

No final da configuração, você receberá um token de API específico do projeto. Copie-o e armazene-o com segurança — você precisará dele para autenticar todas as requisições. Você sempre pode encontrar o mesmo token novamente no painel do seu projeto em Configurações → Tokens de API da PTC.

4Adicione o token de API da PTC ao seu repositório no local correto.

5Copie a configuração pronta de CI/CD.

No GitHub Actions, adicione a PTC Translate action ao seu fluxo de trabalho. Seu token de API é a única entrada que você precisa passar. A action carrega uma versão fixa da CLI dentro de si, para que seu build nunca baixe um script no momento da execução, e quando uma execução produz novas traduções, ela abre o pull request para você.

No GitLab CI, Bitbucket Pipelines ou qualquer outra plataforma, copie o job para a sua plataforma a partir dos modelos de CI/CD da PTC CLI. Cada modelo fixa a CLI a um lançamento específico e publica o checksum para verificação, para que um lançamento posterior da CLI não possa alterar o que o seu build executa.

6Execute o fluxo de trabalho.

Você pode acionar o fluxo de trabalho manualmente, em commits que atualizam arquivos de recursos, ou de forma agendada. Veja os gatilhos para GitHub, GitLab e Bitbucket. Um pull request precisa de um branch para ser aberto; portanto, no GitHub Actions, a PTC Translate action abre um em um push, em um agendamento e em uma execução manual a partir de um branch. Em um evento pull_request, pull_request_target ou merge_group, ou em uma tag ou lançamento, ela para com uma explicação em vez disso - traduza em um push para o seu branch de origem, ou defina create-pr: false para essa execução.

Quando é executada, a CLI faz o upload dos seus arquivos, aguarda a conclusão das traduções e grava as traduções atualizadas de volta no seu repositório. Se você estiver usando as configurações prontas e a execução produzir novas traduções, o fluxo de trabalho também create a merge request com as alterações, para que você possa revisá-las e fazer o merge como qualquer outra atualização de código. Uma execução que não encontra nada para traduzir não grava nada e não abre nenhum merge request. A partir daqui, suas traduções permanecem sincronizadas automaticamente.

Exemplos de CI/CD

WordPress

• GitHub Actions
• GitLab CI

Ruby on Rails

• GitHub Actions

Arquivos JSON (Aplicativos React)

• GitHub Actions
• GitLab CI

Glossário e memória de tradução por projeto

Adicione uma entrada de glossário uma vez. Por exemplo: “Cart = Carrito” para o espanhol. A PTC aplica a entrada em cada arquivo no mesmo projeto, agora e em cada atualização futura. Você nunca faz re-upload de arquivos TMX entre execuções.

Você pode gerenciar as entradas do glossário de duas maneiras. O painel da PTC fornece um editor para entradas ad-hoc. A API REST da PTC suporta importação e exportação de glossário para equipes que mantêm a terminologia em um sistema separado.

Edite ou retraduza qualquer string após ela ser gerada

A PTC nunca bloqueia uma tradução. Você pode revisar, editar ou pedir à PTC para retraduzir qualquer string a partir da aba Translations a qualquer momento, para que sua equipe mantenha a palavra final sobre cada palavra que é lançada.

A PTC suporta todos os formatos comuns de recursos sem configuração extra

A PTC lida com os formatos que sua stack realmente usa. Os formatos nomeados abaixo têm links para suas páginas de tradução dedicadas:

• Web: JSON (i18next, react-intl, vue-i18n, next-intl), YAML (Rails), PO/POT (Django, WordPress).
• iOS: .strings, .stringsdict, .xcstrings (String Catalogs).
• Android: strings.xml, plurais, arrays de strings.
• Desktop / multiplataforma: .properties (Java), .po (gettext).
• Dados / catálogos: CSV, XLIFF.

A localização de software não começa e termina na interface do usuário. A PTC também traduz notas de lançamento, notificações por e-mail, documentação de ajuda, materiais de marketing, feedback de usuários e relatórios de bugs. Tudo no mesmo projeto, para que a terminologia permaneça consistente em tudo que seus usuários tocam.

Veja a matriz completa de suporte a formatos e idiomas para a lista completa.

Faça lançamentos em mais de 40 idiomas, do árabe ao japonês

A PTC traduz para mais de 40 idiomas, incluindo árabe, chinês, francês, alemão, japonês, coreano, português, espanhol e mais, para que você possa alcançar novos mercados sem adicionar uma nova ferramenta para cada um. Veja a lista completa de idiomas suportados para confirmar se seus alvos estão cobertos.

Traduza notas de lançamento multiplataforma, e-mails para clientes e documentos de suporte

Notas de lançamento multiplataforma, e-mails voltados para o cliente, documentação de suporte e textos do site de marketing vivem fora dos seus arquivos de recursos. O Paste to Translate da PTC lida com esses textos no mesmo projeto. Cole o texto de origem, escolha os idiomas de destino e receba de volta traduções que usam o mesmo glossário e voz da marca que suas strings no aplicativo.

Traduza conteúdo gerado pelo usuário, tickets de suporte e dados dinâmicos com a API da PTC

O conteúdo gerado pelo usuário, os tickets de suporte e os dados dinâmicos que o seu software manipula no momento da execução precisam de tradução assim que chegam. A API REST da PTC traduz esse conteúdo sob demanda com autenticação por token Bearer, usando o mesmo glossário e voz da marca que as traduções dos seus arquivos de recursos.

Preços: teste de 30 dias, depois Pay-As-You-Go

O teste cobre 20.000 palavras para 2 idiomas sem cartão de crédito. Quando o teste termina, a PTC oferece o Pay-As-You-Go. Sem assinatura. Sem compromisso mínimo. As primeiras 500 palavras de cada mês são gratuitas. Você só paga pelo restante. A página de preços possui uma calculadora de custos. Inscreva-se com um e-mail corporativo para um teste empresarial estendido.

A PTC possui certificação ISO 27001 para uso corporativo

A PTC possui certificação ISO 27001, o que significa que seus dados e os dados dos seus usuários são tratados segundo padrões de segurança reconhecidos internacionalmente. A PTC suporta a localização contínua para equipes de engenharia de todos os tamanhos, desde uma startup com 3 desenvolvedores até uma empresa que faz lançamentos semanais em 12 idiomas.

Siga um caminho comprovado desde a primeira string até o lançamento

Começar é simples quando você tem um mapa. Nosso guia de localização de software orienta você por tudo, desde a preparação das suas strings para tradução até o gerenciamento de atualizações à medida que seu produto cresce, para que você adote a PTC com um plano claro em vez de tentativa e erro. Leia o guia de localização de software para configurar seu primeiro projeto.

Pronto para lançar um software multilíngue verificado?

Conecte seu repositório GitHub ou GitLab. A PTC traduz seus arquivos de recursos para mais de 40 idiomas e revisa o aplicativo em execução em cada um deles a cada lançamento. Você faz o lançamento com confiança.

Comece seu teste de 30 dias - 20.000 palavras por nossa conta, nenhum cartão de crédito necessário.

Para desenvolvedores prontos para se aprofundar:

• Leia a referência da API da PTC - endpoints REST, webhooks, integração de CI.
• Veja o suporte a formatos de arquivos e idiomas.
• Fale conosco sobre o plano Enterprise - SLAs personalizados, opções on-premise, suporte dedicado.

Última atualização: 11 de novembro de 2026