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.
São necessários acesso de leitura e escrita para o repositório.
Arquivos de configuração definidos incorretamente podem causar erros. Certifique-se de que o arquivo contenha pelo menos um alvo de push e um de pull, os formatos de arquivo corretos e a configuração correta do parâmetro update_translations.

Arquivo de configuração de exemplo:

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 de Integrações, role para baixo até o conector Sincronização com Bitbucket 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 o Phrase Strings e a conta Bitbucket selecionada é 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.
Selecionar um projeto da 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 principal.
Clique em Validar configuração para garantir que o token de acesso e o arquivo de configuração estão corretos.
Opcionalmente, selecione Importação automática para importar arquivos com cada confirmação no ramo de 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 o Phrase Strings 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 o pedido 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.

As traduções são enviadas para o repositório.
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 do Phrase Strings.

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.