Integração do GitLab com a PTC
Conecte o GitLab com a PTC para localização contínua. Receba traduções entregues por meio de merge requests automáticos sempre que o seu código mudar.
Como integrar o GitLab com a PTC
A PTC se conecta ao seu repositório GitLab e mantém seus arquivos de recursos traduzidos enquanto você trabalha. Faça o push de alterações no seu código e a PTC as detectará automaticamente, traduzirá as strings atualizadas e abrirá um merge request.
A integração com GitLab é um recurso Pro. Ela fica disponível quando você ativa o Pay-As-You-Go.
Conecte seu repositório GitLab
A PTC é compatível tanto com o GitLab.com quanto com repositórios GitLab auto-hospedados. Dependendo de onde você está no seu fluxo de trabalho, há duas maneiras de começar:
- Ao criar um novo projeto na PTC, selecione Integração com Git no assistente de configuração.
- Para mudar um projeto existente de uploads manuais de arquivos para um fluxo de trabalho contínuo baseado em Git, vá para Configurações → Merge Requests e clique em Add Git Integration.
Em ambos os casos, você verá uma tela onde pode inserir a URL do seu projeto dentro do repositório. A PTC detectará automaticamente que você está usando o GitLab.
Autentique-se com o GitLab
Para conectar seu repositório, você pode usar um token de acesso (recomendado) ou fazer login com OAuth. A PTC é compatível com tokens de acesso de projeto e tokens de acesso de grupo.
A PTC exige acesso a webhooks para detectar alterações no seu repositório. Ao usar um token de acesso, o papel e os escopos necessários dependem de como você deseja configurar o webhook:
| Configuração automática de webhook | Configuração manual de webhook | |
|---|---|---|
| Como funciona | A PTC cria e configura o webhook no GitLab em seu nome durante o fluxo de integração. | A PTC fornece a você uma URL de callback e um Secret Token. Você cria um webhook nas configurações do seu GitLab usando esses detalhes, com eventos de Push e eventos de Merge request como gatilhos. |
| Criando o token | Vá para Configurações → Tokens de acesso, no seu projeto ou no seu grupo. Dê um nome ao token, uma descrição opcional e defina uma data de expiração (recomendado por segurança). | Vá para Configurações → Tokens de acesso, no seu projeto ou no seu grupo. Dê um nome ao token, uma descrição opcional e defina uma data de expiração (recomendado por segurança). |
| Papel necessário | Mantenedor | Desenvolvedor (ou equivalente) |
| Escopos | api → Permite que a PTC leia e faça push no repositório |
read_repository + write_repository |
Tanto um token de projeto quanto um token de grupo funcionam em qualquer uma das colunas — a PTC lê o nível de acesso que for mais alto. O que separa as duas colunas é o papel, e isso decorre do que cada configuração faz: a configuração automática gerencia um webhook de projeto para você, que o GitLab reserva para o Mantenedor, enquanto a configuração manual apenas lê o repositório e faz o push em um branch, então o Desenvolvedor é suficiente.
Armazene o token com segurança e adicione-o à PTC. Ela verificará suas permissões e permitirá que você escolha quais branches e arquivos de recursos monitorar.
O acesso permanece limitado aos arquivos que a PTC traduz
A PTC usa acesso de leitura para detectar alterações nos seus arquivos de recursos e acesso de gravação para entregar traduções por meio de merge requests. A PTC interage apenas com os arquivos que gerencia para tradução e não faz alterações em nenhuma outra parte do seu repositório.
Os webhooks mantêm as traduções sincronizadas automaticamente
Os webhooks são a forma como a PTC é notificada quando você faz o push de alterações no seu repositório, para que ela possa retraduzir as strings afetadas automaticamente. Sem acesso a webhooks, a PTC não pode monitorar seus branches em busca de atualizações.
Traduza seu projeto com a PTC
Assim que o seu repositório GitLab estiver conectado, continue pelas etapas de configuração para fornecer algum contexto sobre o seu aplicativo ou software e escolha seus idiomas de destino.
A PTC, então, traduzirá os arquivos de recursos no seu branch conectado do GitLab. Se o seu repositório já contiver arquivos de tradução, a PTC poderá detectá-los e reutilizá-los.
Revise o merge request com as traduções
A PTC traduz em minutos e envia um merge request com as traduções diretamente para o seu repositório GitLab. Quando você estiver pronto, basta fazer o merge — nenhuma outra ação é necessária.
A partir desse ponto, conforme você fizer o push de alterações no seu código, a PTC as detectará e enviará novos merge requests com traduções atualizadas, mantendo o seu software totalmente localizado ao longo do tempo.
Gere novos merge requests manualmente
Além das atualizações automáticas, você pode gerar um novo merge request a qualquer momento para sincronizar as traduções que você editou ou retraduziu.
Para fazer isso, vá para a aba Translations. A partir daqui, você pode revisar o texto traduzido que excede o limite de comprimento e editá-lo manualmente ou deixar que a PTC gere uma versão mais curta. Quando terminar, clique em Generate MR para fazer o push das traduções atualizadas para o seu repositório.
Dê à PTC acesso a novos arquivos de recursos conforme você os adiciona
Se você adicionar novos arquivos de recursos ao seu repositório após a integração inicial, poderá pedir à PTC para procurá-los.
- Vá para Configurações → Arquivos Monitorados e clique em Rescan your repository. A PTC fará a varredura no seu repositório e exibirá quaisquer arquivos recém-descobertos como rascunhos.
- Clique no ícone + ao lado de um arquivo para incluí-lo para tradução, e então clique em Save with translation para confirmar.
Para pular totalmente a revisão manual, marque a caixa de seleção Automatically include new translation files. A partir desse ponto, a PTC detectará e monitorará automaticamente quaisquer novos arquivos de recursos que encontrar, sem exigir que você os confirme.
Para ajustar outras configurações, como branches monitorados e idiomas, navegue pelas abas Gerenciamento de branches, Arquivos Monitorados e Idiomas.
Por que localizar projetos do GitLab com a PTC
Tradução automatizada de arquivos
A PTC detecta e traduz automaticamente os seus arquivos de recursos, entregando as traduções por meio de merge requests. Você mantém o controle usando o fluxo de trabalho do GitLab que já conhece e confia — e sem a necessidade de criar nenhum script.
Menos trabalho manual
A PTC economiza tempo de desenvolvimento e acelera os lançamentos monitorando o seu repositório e atualizando os arquivos de tradução conforme você faz o push de alterações.
Maior precisão de tradução
A PTC elimina o risco de erros humanos, como chaves mal posicionadas ou traduções desatualizadas. Você obtém traduções altamente precisas e alinhadas à marca.
A localização acompanha o ritmo do desenvolvimento de software e mobile
A PTC foi projetada para equipes que criam produtos de software e aplicativos móveis e desejam que a localização acompanhe o ritmo do desenvolvimento. Assim que você conecta o seu repositório GitLab, a PTC detecta automaticamente strings novas e atualizadas e entrega as traduções de volta por meio de um merge request, sem a necessidade de transferências manuais.
Formatos comuns em projetos de software e mobile — como arquivos PO e arquivos JSON — são totalmente suportados. Para saber mais sobre como a PTC se encaixa nesses fluxos de trabalho, consulte nossas páginas de localização de software e localização de aplicativos móveis.
Conecte o GitLab sem custo extra
Não há cobrança adicional para conectar o GitLab. Em vez de um modelo de assinatura, a PTC usa um preço simples de Pay-As-You-Go: você só é cobrado pelas palavras que traduzir, e as primeiras 500 palavras de cada mês são gratuitas. Todos os detalhes estão na página de preços da PTC.
Funciona também com o GitHub e o Bitbucket
Além do GitLab, a PTC se integra ao GitHub e ao Bitbucket, oferecendo os mesmos fluxos de trabalho e recursos automatizados de localização para cada plataforma.