Visão geral
O editor de código-fonte Git (ci.android.com/edit) é uma ferramenta baseada em navegador para editar arquivos no Android Open Source Project (AOSP) e enviar alterações para o Gerrit. Destina-se a fazer pequenas alterações em um pequeno número de arquivos e fornece um fluxo de trabalho mais rápido do que baixar a árvore de origem do Android . Você deve estar familiarizado com o processo completo de envio de alterações ao AOSP usando Git, Repo e Gerrit antes de usar o editor de código-fonte Git.
Quando você edita um arquivo usando o editor de código-fonte Git, todo o trabalho acontece em sua máquina local, até que você carregue as alterações para criar uma lista de alterações Gerrit.
Conecte-se
- Carregue o Git Source Editor em um navegador.
Clique em Login para fazer login em sua conta.
Figura 1. Botão Login
Editar arquivos e alterações
O Git Source Editor tem estes fluxos de trabalho principais:
- Edite um ou mais arquivos de sua preferência, no branch que você escolher.
- Edite uma alteração. Quando você edita uma alteração, o resultado depende de quem a criou:
- Se você criou a alteração, as edições do Editor de código-fonte do Git serão corrigidas na alteração como um novo conjunto de patches.
- Se outra pessoa criou a alteração, as edições do Editor de código-fonte do Git criarão uma nova alteração de sua propriedade, com base na alteração que você carregou.
Carregue o que você deseja editar
Inicie uma sessão de edição carregando um arquivo ou uma alteração.
Carregar arquivos
Insira o URL do arquivo que deseja editar na caixa arquivo/alterar caminho na parte superior da página.
Exemplo de caminho do arquivo: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md
Clique em Carregar arquivo ou alterar .
Figura 2. Carregando um arquivo ou alteração
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 seu arquivo pré-carregado.
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 arquivo aparecerá como uma guia na linha acima do painel de edição. Clique em uma guia para abrir esse arquivo no painel de edição.
Figura 4. Guias para arquivos carregados
Carregar uma alteração
Navegue até a alteração que deseja editar inserindo a URL de uma lista de alterações Gerrit na caixa arquivo/caminho da alteração na parte superior da página (veja a Figura 2).
Exemplo de link de alteração: https://android-review.googlesource.com/c/platform/build/soong/+/1284176
Os arquivos na alteração são abertos no painel de edição (veja a Figura 3).
Se a alteração 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 esse arquivo no painel de edição.
Faça suas edições
Edite arquivos usando o painel de edição de texto. Os arquivos que você edita 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á reabrir o arquivo com as edições intactas clicando em seu nome na lista Alterações pendentes.
Enviar alterações
Você cria e publica sua alteração no Gerrit no Git Source Editor. Depois você acompanha a aprovação da mudança no Gerrit.
Crie e publique as alterações
Siga este procedimento para criar e publicar as alterações feitas.
Clique no botão apropriado:
- Clique em Criar alteração se estiver criando uma nova alteração.
- Clique em Atualizar alteração se estiver atualizando uma alteração existente.
Uma caixa de diálogo é aberta.
Figura 5. Caixa de diálogo Criar Alteração
Insira uma descrição da alteração, que se tornará a descrição da alteração no Gerrit. Esta descrição é obrigatória. Se estiver editando uma alteração existente, você poderá editar sua descrição, se desejar.
Opcionalmente, desmarque ou marque a caixa de seleção Publicar ao criar .
Esta caixa está selecionada por padrão.
Se esta caixa for selecionada quando você criar a alteração, a alteração será imediatamente publicada no Gerrit. Se a caixa não estiver selecionada, a alteração será carregada no Gerrit, mas não será publicada.
Clique em Criar .
A alteração é carregada no Gerrit. Se você marcou a caixa de seleção Publicar ao criar , a alteração também será publicada no Gerrit. A mudança está vinculada em uma notificação na parte superior da tela.
Figura 6. Notificação de alteração criada
Acompanhe a aprovação de alterações no Gerrit
Acompanhe o status de envio de alterações diretamente no Gerrit, como faria com qualquer outra alteração.
Figura 7. Acompanhamento do status de envio de alterações no Gerrit
Ver diferenças de arquivos
Marque a caixa de seleção Diferença abaixo do painel de edição para visualizar as diferenças das edições feitas no arquivo que está ativo no painel de edição. Isto é útil ao alterar um arquivo e ao editar uma alteração existente.
Figura 8. Visualizando diferenças de arquivos
Reverter arquivos
Você pode reverter alterações de um único arquivo ou de todos os arquivos da lista de alterações pendentes. Ambas as opções de reversão revertem alterações apenas 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 próximo ao nome do arquivo na lista Alterações pendentes.
Figura 9. Seção de alterações pendentes
Reverter todos os arquivos
Para reverter todos os arquivos de uma vez, clique em Reverter todos os arquivos abaixo do painel de edição.
Figura 10. Botão Reverter todos os arquivos
Uma caixa de diálogo pop-up é aberta. Clique em Reverter tudo para reverter as alterações em todos os arquivos pendentes ou clique em Cancelar para manter as alterações e continuar editando.
Figura 11. Caixa de diálogo de confirmação de reverter todos os arquivos
Edite uma página diretamente da pesquisa de código do Android
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.
No Android Code Search (cs.android.com), navegue até o arquivo que deseja editar.
Clique em Editar código .
Figura 12. Botão Editar código do Android Code Search
O Git Source Editor é aberto com o arquivo pré-selecionado para edição.
Selecione a ramificação Git na qual deseja editar o arquivo na lista suspensa Selecionar uma ramificação git e clique em Selecionar ramificação .
Figura 13. Selecionando uma ramificação Git para editar
O arquivo é aberto no painel de edição.
Continue editando conforme descrito na seção Fazendo suas edições .
Você pode abrir arquivos adicionais para editar conforme descrito na seção Carregando arquivos
Resolver conflitos
Para resolver conflitos:
No Editor de código-fonte, navegue até a alteração. Após o carregamento da alteração, os arquivos conflitantes serão listados na parte inferior da tela. Por exemplo, a Figura 14 mostra que o arquivo
Android.pbapresenta um conflito.
Figura 14. Conflito do editor de código-fonte
Clique em um arquivo conflitante. O arquivo carrega e mostra blocos de conteúdo conflitantes em sucessão e dentro dos marcadores Git (
<<<<<<<e>>>>>>>).
Figura 15. Marcadores de conflito do editor de código-fonte
Corrija o conflito editando o arquivo e removendo manualmente os marcadores de conflito em torno do conteúdo que você deseja manter. Além disso, remova o conteúdo e os marcadores de conflito do conteúdo que você não deseja manter.
Clique em Criar alteração para criar uma nova alteração. A caixa de diálogo Criar alteração é exibida.
Figura 16. Criar mudança
Digite uma descrição da alteração e clique em Criar .
Enviar comentários
Use o botão de bug
no canto superior direito para fornecer feedback sobre o Git Source Editor.