Gerenciamento de versões
Mantenha um processo de localização ágil e evite atrasos na tradução de textos adicionados ou novos recursos do produto. Integre as ramificações do seu projeto com o Crowdin e permita que os tradutores acessem imediatamente todos os novos textos.
Ramificações
Quando várias pessoas estão trabalhando no desenvolvimento de produtos, as ramificações ajudam a gerenciar diferentes versões do conteúdo. Se você tiver um projeto contínuo, poderá adicionar ramificações ao Crowdin e permitir que os tradutores traduzam os textos em paralelo com o desenvolvimento, para evitar atrasos na implantação.
A ramificação no Crowdin parece uma pasta comum marcada com um ícone especial e possui um comportamento específico para sequências de caracteres duplicadas.
O exemplo de uma estrutura de arquivos no sistema de controle de versão (VCS) e Crowdin: 
Criação de ramificação
Nota! Os primeiros arquivos carregados no projeto Crowdin devem conter todas as cadeias originais e devem ser colocados na ramificação correspondente. Para todos os exemplos de artigos, um ramo com textos originais é nomeado Master.
Existem algumas maneiras de adicionar ramificações ao Crowdin:
- Integrar projetos Crowdin com GitLab, GitHub, ou Bitbucket. É uma opção recomendada, pois as ramificações selecionadas para localização no seu sistema de controle de versão (VCS) serão criadas automaticamente no Crowdin
- Use CLI ou API para adicionar novas ramificações
- Crie ramificações manualmente, acessando Configurações do projeto > Arquivos > Nova ramificação da versão
Criação de ramificação usando API
Para criar um ramo via API, use o Adicionar diretório método com is_branch=1 parâmetro:
POST https://api.crowdin.com/api/project/{project-identifier}/add-directory?key={project-key}&name={branch_name}&is_branch=1
Adicionar arquivo, Atualizar arquivo, Carregar Traduções e outros métodos que manipulam arquivos e pastas funcionam com parâmetro branch={branch_name}.
Gerenciamento de ramificação usando CLI
Não há necessidade de executar um comando específico para criar ramificações de versão se a CLI for usada. O ramo da versão seria criado automaticamente enquanto o upload de arquivos. Exemplo dos arquivos de origem / upload de traduções para o ramo de versão especificado:
$ crowdin upload sources -b branch_name
$ crowdin upload translations -b branch_nameDuplicatas
Como as ramificações são as diferentes versões do mesmo recurso do produto, o conteúdo da localização nelas geralmente é duplicado. To help translators translate versions consistently and avoid additional translation costs, we have the Show within a version branch option that allows hiding duplicated strings only between versions. If your source files contain strings with apparent identifiers (keys), it’s better to use a strict version of this option. Em outros casos, sinta-se à vontade para usar uma normal.
Quando essa opção é selecionada, apenas nos textos originais que foram carregadas pela primeira vez no sistema devem ser convertidas. Todas as cadeias duplicadas obterão automaticamente as traduções das cadeias originais.
Fluxo de trabalho sugerido
Para garantir que as versões funcionem sem problemas no seu projeto Crowdin, recomendamos o seguinte fluxo de trabalho:
- Carregue seus arquivos de projeto no projeto Crowdin usando um dos seguintes métodos disponíveis.
- Vá para Configuração do projeto > Traduções > Duplicatas e escolha a opção recomendada para versões.
A captura de tela abaixo mostra como o fluxo de trabalho funciona na prática. Todos os textos de Master, Branch 1 e Branch 2 são transferidos para o servidor de tradução imediatamente após aparecerem, mesmo que as ramificações não sejam mescladas com o ramo Master ainda. 
Exportar traduções
As traduções de todas as ramificações de versão são colocadas em um arquivo ZIP quando são baixadas pela interface da web. Use the CLI or API to download the translations for each branch individually.
Exportar traduções usando API
Exportar traduções do ramo da versão especificada:
GET https://api.crowdin.com/api/project/{project-identifier}/export?key={project-key}&branch={branch_name}
Download de traduções do ramo da versão especificada:
GET https://api.crowdin.com/api/project/{project-identifier}/download/{package}.zip?key={project-key}&branch={branch_name}
Exportar traduções usando CLI
Download de traduções do ramo da versão especificada:
$ crowdin download -b branch_nameMesclando ramificações
A ramificação Master conterá novos textos das ramificações Feature assim que elas forem mescladas. Durante a sincronização com o Crowdin, todos os textos no ramo Master são preenchidos com traduções do ramo apropriado.
Após a sincronização do arquivo de ramificação atualizado Master com Crowdin, a ramificação Feature can pode ser removido do Crowdin. Todas as traduções armazenadas na ramificação Master permanecerá.
Verificação da tradução da ramificação
Você pode verificar as traduções na produção usando apenas a ramificação Feature antes que as alterações sejam mescladas com a ramificação Master. Essa implementação de teste oferece uma opção de reversão rápida para a versão de ramificação original Master, se necessário.
