Bitbucket (Strings)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Dica

Para informações sobre a integração do Bitbucket no Phrase TMS, consulte o Bitbucket Cloud (TMS).

A sincronização do Bitbucket é suportada apenas para o Bitbucket Cloud. Não pode ser usada com o Bitbucket Server.
A sincronização do Bitbucket pode ser usada via API.

Pré-requisitos

O arquivo .phrase.yml de configuração deve estar presente na raiz do ramo a ser monitorado. O arquivo define quais arquivos importar (pull) ou exportar (push) do repositório.
O acesso à leitura e edição é necessário no repositório.
Arquivos de configuração com definição incorreta podem causar erros. Certifique-se de que o arquivo contenha pelo menos um destino de push e pull, os formatos de arquivo corretos e a configuração correta do parâmetro update_translations.

Amostra de arquivo de configuração:

phrase:
    project_id: 1f61b9ecdb7a17a9dd174302419c50cc
    file_format: simple_json
    push:
        sources:
            - file: ./<locale_name>.json
    pull:
        targets:
            - file: ./<locale_name>.json

A ID de um projeto é encontrada nas configurações do projeto.

Conectar repositórios

Uma vez que o arquivo de configuração esteja no lugar, para conectar um repositório, siga estas etapas:

Na página Integrações, role para baixo até Sincronização de Repositório e clique em Configurar.

A página Sincronizações de Repositório será aberta.
Clique em Adicionar Sincronização/Bitbucket.

A página de ativação da sincronização com o Bitbucket será aberta.
Selecione a conta do Bitbucket a ser conectada na lista suspensa Autorizar para o espaço de trabalho e clique em Conceder acesso.

A conexão entre Strings do Phrase e a conta do Bitbucket selecionada está estabelecida. A janela de configurações da sincronização com Bitbucket será exibida.

Nota

Não é possível conectar várias contas via a integração do Bitbucket.
Selecione um projeto na lista suspensa.
Selecione um repositório do Bitbucket na lista suspensa.

Se a propriedade do repositório não estiver correta, o repositório não será visível na lista suspensa.
Selecione um ramo do repositório na lista suspensa para importar (push) e exportar (pull). Este é geralmente o ramo master.
Clique em Validar Configuração para garantir que as configurações de autenticação e o arquivo de configuração estão corretos.
Opcionalmente, selecione Importação automática para importar arquivos com cada confirmação no ramo do Bitbucket selecionado.
Clique em Gravar.

O projeto agora está conectado ao repositório do Bitbucket selecionado e adicionado à lista.

As integrações podem ser desativadas ou removidas na página Sincronizações de Repositório.

Opcionalmente, os usuários podem remover uma integração do Bitbucket revogando a autorização para Strings do Phrase em suas configurações pessoais do Bitbucket.

Importar do Bitbucket

Após ativar a sincronização do Bitbucket e conectar um repositório, arquivos locais podem ser importados. Isso é feito na forma de solicitações de pull, para que as alterações possam ser revisadas e a gestão de ramos possa ser controlada.

Para importar arquivos locais do Bitbucket, siga estas etapas:

Na página Sincronizações de repositório, selecione um projeto e clique em Importar .

As traduções são importadas para o projeto. As chaves e as traduções atuais são atualizadas.
Aprovar, mesclar ou fechar a solicitação de pull no Bitbucket.

Exportar para o Bitbucket

Para exportar arquivos locais para o Bitbucket, siga estas etapas:

Na página Sincronizações de repositório, selecione um projeto e clique em Exportar .

A janela Exportar é exibida.
Forneça o ramo de destino no campo Ramo PR.

Os arquivos mais recentes no repositório serão exportados como uma nova solicitação de pull para o ramo desejado.
Uma vez que os arquivos são exportados, a solicitação de pull pode ser mesclada ou fechada no repositório e o ramo pode ser excluído.

Histórico

As sincronizações de repositório mantêm um histórico das últimas importações e exportações para cada projeto de Strings do Phrase.

Para visualizar o histórico:

Na página Sincronizações de repositório, selecione um projeto e clique em Histórico .

O histórico de importação e exportação do projeto é apresentado. As entradas de exportação no histórico incluem um link para o pedido de mesclagem correspondente.