Integração do GitLab com a PTC
Conecte o GitLab à PTC para uma localização contínua. Receba traduções entregues por meio de merge requests automáticos sempre que seu código mudar.
Como integrar o GitLab à PTC
A PTC se conecta ao seu repositório do GitLab e mantém seus arquivos de recursos traduzidos enquanto você trabalha. Faça o push das 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 do GitLab
A PTC oferece suporte tanto ao GitLab.com quanto a repositórios do 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, acesse Configurações → Merge Requests e clique em Add Git Integration.
Em ambos os casos, você verá uma tela onde poderá inserir o URL para o 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 suporta tanto tokens de acesso de projeto quanto 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 de que você precisa dependem de como você deseja que o webhook seja configurado:
| 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ê um URL de callback e um Token secreto. 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 | Acesse 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). | Acesse 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 de e faça push para o 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ê, o qual o GitLab reserva para o Mantenedor, enquanto a configuração manual apenas lê o repositório e faz o push de um branch, entã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 ela 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 consegue monitorar seus branches em busca de atualizações.
Traduza seu projeto com a PTC
Assim que seu repositório do GitLab estiver conectado, continue pelas etapas de configuração para fornecer algum contexto sobre 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 do GitLab. Quando você estiver pronto, basta fazer o merge dele — nenhuma outra ação é necessária.
A partir desse ponto, conforme você faz o push de alterações no seu código, a PTC as detectará e enviará novos merge requests com traduções atualizadas, mantendo 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, acesse 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 que verifique se eles existem.
- Acesse Configurações → Arquivos Monitorados e clique em Rescan your repository. A PTC verificará 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, em seguida, clique em Save with translation para confirmar.
Para pular a revisão manual inteiramente, marque a caixa de seleção Automatically include new translation files. A partir desse ponto, a PTC capturará 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 Branch Management, Arquivos Monitorados e Idiomas.
Por que localizar projetos do GitLab com a PTC
Tradução automática de arquivos
A PTC detecta e traduz automaticamente 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 em que confia — e sem a necessidade de criar nenhum script.
Menos trabalho manual
A PTC economiza tempo de desenvolvimento e acelera os lançamentos monitorando 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 aplicativos móveis
A PTC foi projetada para equipes que criam produtos de software e aplicativos móveis e que desejam que a localização acompanhe o ritmo do desenvolvimento. Assim que você conecta seu repositório do GitLab, a PTC detecta automaticamente strings novas e atualizadas e entrega as traduções de volta por meio de um merge request, sem necessidade de repasse manual.
Formatos comuns em projetos de software e aplicativos móveis — 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 sobre localização de software e localização de aplicativos móveis.
Conecte o GitLab sem custo extra
Não há cobrança adicional por conectar o GitLab. Em vez de um modelo de assinatura, a PTC usa o preço simples do Pay-As-You-Go: você só é cobrado pelas palavras que traduz, 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.
Também funciona com GitHub e Bitbucket
Além do GitLab, a PTC se integra ao GitHub e ao Bitbucket, oferecendo os mesmos recursos e fluxos de trabalho de localização automatizada para cada plataforma.