Integração do GitLab com a PTC
Conecte o GitLab à PTC para uma localização contínua. Receba traduções entregues via merge requests automáticos sempre que seu código mudar.
Como integrar o GitLab à 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 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 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 do upload manual 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 poderá 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 suporta tanto tokens de acesso de projeto quanto tokens de acesso de grupo.
A PTC requer acesso de webhook para detectar alterações no seu repositório. Ao usar um token de acesso, o papel e os escopos 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ê uma URL de callback e um Token Secreto. Você cria um webhook nas suas configurações do GitLab usando esses detalhes, com eventos de Push e eventos de Merge request como gatilhos. |
| Criando o token | No seu projeto, vá para Configurações → Access Tokens. Dê um nome ao token, uma descrição opcional e defina uma data de expiração (recomendado por segurança). | No seu grupo, vá para Configurações → Access Tokens. 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 para o repositório |
read_repository + write_repository |
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 via 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 push de alterações no seu repositório, para que ela possa retraduzir as strings afetadas automaticamente. Sem acesso de webhook, a PTC não pode monitorar seus branches em busca de atualizações.
Traduza seu projeto com a PTC
Assim que seu repositório GitLab estiver conectado, continue pelas etapas de configuração para fornecer algum contexto sobre seu aplicativo ou software e escolher 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ê faz 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, 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 verificá-los.
- Vá para 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 de + ao lado de um arquivo para incluí-lo na tradução e, em seguida, 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 automática de arquivos
A PTC detecta e traduz automaticamente seus arquivos de recursos, entregando as traduções via 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 seu repositório e atualizando os arquivos de tradução à medida que você faz push das 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 desenvolvimento de software e de aplicativos móveis
A PTC foi projetada para equipes de software que criam produtos e aplicativos móveis e desejam que a localização acompanhe o desenvolvimento. Assim que você conecta 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 necessidade de repasse manual.
Formatos comuns em projetos de software e dispositivos móveis — como arquivos PO e arquivos JSON — são totalmente suportados. Para saber mais sobre como a PTC se integra a esses 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 modelo de preço Pay-As-You-Go simples: 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 automatizados para cada plataforma.