Google is committed to advancing racial equity for Black communities. See how.

Git Source Editor

Visão geral

O Git Source Editor (ci.android.com/edit) é uma ferramenta baseada em navegador para editar arquivos no Android Open Source Project (AOSP) e fazer upload de mudanças no Gerrit. Ele se destina a fazer pequenas mudanças em alguns arquivos e fornece um fluxo de trabalho mais rápido do que o download da árvore de origem do Android. Familiarize-se com todo o processo de envio de mudanças para o AOSP usando o Git, o Repo e o Gerrit antes de usar o Git Source Editor.

Ao editar um arquivo usando o Git Source Editor, todo o trabalho acontece na máquina local, até que você faça o upload para criar uma lista de mudanças do Gerrit.

Como efetuar login

  1. Carregue o Git Source Editor (link em inglês) em um navegador.
  2. Clique em Login para fazer login na sua conta.

    Botão

    Figura 1. Botão "Login"

Como editar arquivos e modificações

O Git Source Editor tem estes fluxos de trabalho principais:

  • Edição de um ou mais arquivos de sua escolha na ramificação escolhida.
  • Edição de uma mudança. Ao editar uma mudança, o resultado dependerá de quem a criou:
    • Se você criou a mudança, as edições do Git Source Editor serão corrigidas como um novo conjunto de patches.
    • Se outra pessoa a criou, as edições do Git Source Editor criarão uma nova mudança com base naquela que foi carregada.

Como carregar o que você quer editar

Inicie uma sessão de edição carregando um arquivo ou uma mudança.

Carregando arquivos

  1. Digite o URL do arquivo que você quer editar na caixa file/change path na parte superior da página.

    Exemplo de caminho de arquivo: https://android.googlesource.com/platform/build/+show/refs/heads/master/Changes.md

  2. Clique em Load file or change.

    Como carregar um arquivo ou uma mudança

    Figura 2. Como carregar um arquivo ou uma mudança

    O arquivo é carregado no painel do editor. O painel de navegação à esquerda do painel do editor é um navegador de arquivos, que abre o repositório, com o arquivo pré-carregado.

    Um arquivo carregado no painel de edição Figura 3. Um arquivo carregado no painel de edição

Você pode usar o painel de navegação para abrir mais arquivos no mesmo repositório. Se você abrir vários arquivos, cada um deles aparecerá como uma guia na linha acima do painel de edição. Clique em uma guia para abrir o arquivo no painel de edição.

Guias para arquivos carregados

Figura 4. Guias para arquivos carregados

Como carregar uma mudança

Navegue até a mudança que você quer editar inserindo o URL de uma lista de mudanças do Gerrit na caixa file/change path na parte superior da página (veja a Figura 2).

Exemplo de link de mudança: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

Os arquivos na mudança são abertos no painel de edição (veja a Figura 3).

Se a mudança incluir vários arquivos, cada arquivo aparecerá como uma guia na linha acima do painel de edição (veja a Figura 4). Clique em uma guia para abrir o arquivo no painel de edição.

Como fazer edições

Edite arquivos usando o painel de edição de texto. Os arquivos editados aparecem na lista "Alterações pendentes" abaixo do painel de edição. Se você fechar acidentalmente a guia de um arquivo com edições, poderá reabri-lo com as edições intactas clicando no nome dele na lista "Alterações pendentes".

Como enviar mudanças

Crie e publique sua mudança no Gerrit no Git Source Editor. Em seguida, acompanhe a aprovação da mudança no Gerrit.

Como criar e publicar as mudanças

Siga este procedimento para criar e publicar as mudanças feitas.

  1. Clique no botão apropriado:

    • Clique em Create change se você estiver criando uma nova mudança.
    • Clique em Update change se estiver atualizando uma mudança.

    Uma caixa de diálogo será aberta.

    Caixa de diálogo

    Figura 5. Caixa de diálogo "Criar mudança"

  2. Insira uma descrição da mudança, que passará a constar no Gerrit. Essa descrição é obrigatória. Se você estiver editando uma mudança, poderá editar a descrição dela, se quiser.

  3. Opcionalmente, desmarque ou marque a caixa de seleção Publish on create.

    Essa caixa está selecionada por padrão.

    Se essa caixa estiver selecionada quando você criar a mudança, ela será publicada imediatamente no Gerrit. Se a caixa não estiver selecionada, a mudança será enviada para o Gerrit, mas não será publicada.

  4. Clique em Create.

    A mudança será enviada para o Gerrit. Se você tiver marcado a caixa de seleção Publish on create, a mudança também será publicada no Gerrit. A mudança está vinculada a uma notificação na parte superior da tela.

    Notificação de mudança criada

    Figura 6. Notificação de mudança criada

Como acompanhar a aprovação de mudanças no Gerrit

Acompanhe o status do envio de mudanças diretamente no Gerrit, como faria com qualquer outra.

Acompanhamento do status de envio de mudanças no Gerrit

Figura 7. Acompanhamento do status de envio de mudanças no Gerrit

Como visualizar diferenças entre arquivos

Marque a caixa de seleção Diff abaixo do painel de edição para ver as diferenças das edições feitas no arquivo ativo no painel de edição. Isso é útil ao modificar um arquivo e ao editar uma mudança.

Como visualizar diferenças entre arquivos

Figura 8. Como visualizar diferenças entre arquivos

Como reverter arquivos

Você pode reverter mudanças de um único arquivo ou de todos os arquivos na lista de mudanças pendentes. Ambas as opções reverterão as mudanças somente no Git Source Editor. Eles NÃO atualizarão a mudança no Gerrit.

Reverter um único arquivo

Para reverter um único arquivo, clique no X ao lado do nome do arquivo na lista "Alterações pendentes".

Seção

Figura 9. Seção "Alterações pendentes"

Reverter todos os arquivos

Para reverter todos os arquivos de uma só vez, clique em Reverter todos os arquivos abaixo do painel de edição.

Botão

Figura 10. Botão "Reverter todos os arquivos"

Uma caixa de diálogo pop-up será aberta. Clique em Reverter tudo para reverter mudanças em todos os arquivos pendentes ou clique em Cancelar para reter as mudanças e continuar editando.

Caixa de diálogo

Figura 11. Caixa de diálogo "Reverter todos os arquivos"

Você pode abrir um arquivo no Git Source Editor diretamente da Pesquisa de código do Android. Isso é útil se você precisar localizar o arquivo antes de editá-lo.

Siga este procedimento para editar um arquivo diretamente da Pesquisa de código do Android.

  1. Na Pesquisa de código do Android (cs.android.com), navegue até o arquivo que você quer editar.
  2. Clique em Editar código.

    Botão

    Figura 12. Botão Editar código da Pesquisa de código do Android

    O Git Source Editor será aberto com o arquivo pré-selecionado para edição.

  3. Selecione a ramificação do Git em que você quer editar o arquivo na lista suspensa Selecionar uma ramificação do git e clique em Selecionar ramificação.

    Como selecionar uma ramificação do Git para edição

    Figura 13. Como selecionar uma ramificação do Git para edição

    O arquivo será aberto no painel de edição.

  4. Continue editando conforme descrito na seção Como fazer edições.

  5. Você pode abrir arquivos adicionais para editar, conforme descrito na seção Como carregar arquivos

Enviar comentários

Use o botão de bug Imagem do botão de bug no canto superior direito para enviar feedback sobre o Git Source Editor.