Visão geral do produto
A interface de pesquisa de código e de origem do Bazel é uma ferramenta baseada na Web para navegar pelos repositórios de código-fonte do Bazel. É possível usar esses recursos para navegar entre diferentes repositórios, ramificações e arquivos. Também é possível conferir o histórico, as diferenças e as informações de culpa.
Primeiros passos
Para acessar a interface de pesquisa de código e de origem, abra https://source.bazel.build no seu navegador da Web.
A tela principal aparece. Essa tela contém os seguintes componentes:
Barra de ferramentas de breadcrumbs. Essa barra de ferramentas exibe seu local atual no repositório e permite mover rapidamente para outro repositório ou local dentro de um repositório, como um arquivo, branch ou commit, por exemplo.
Uma lista de repositórios que você pode procurar.
Na parte de cima da tela, há uma caixa de pesquisa. Use essa caixa para pesquisar arquivos e códigos específicos.
Como trabalhar com repositórios
Como abrir um repositório
Para abrir um repositório, clique no nome dele na tela principal.
Como alternativa, use a barra de ferramentas "Localização atual" para procurar um repositório específico. Essa barra de ferramentas exibe seu local atual no repositório e permite mover rapidamente para outro repositório ou local dentro de um repositório, como um arquivo, branch ou commit, por exemplo.
Mudar de repositório
Para alternar para um repositório diferente, selecione o repositório na barra de ferramentas "Localização atual".
Acessar um repositório em uma confirmação específica
Para acessar um repositório em uma confirmação específica:
- Na visualização do repositório, selecione o arquivo.
- Na barra de ferramentas "Localização atual", abra o menu Branch.
- No submenu que aparece, clique em Confirmar.
- Selecione a confirmação que você quer conferir.
A interface agora mostra o repositório como ele existia nessa confirmação.
Abrir uma ramificação, confirmação ou tag
Por padrão, a interface de pesquisa de código e de origem abre um repositório na ramificação padrão. Para abrir uma ramificação diferente, na barra de ferramentas "Localização atual", clique no menu Ramificação/Confirmação/Tag. Um submenu é aberto, permitindo que você selecione uma ramificação usando o nome dela, o nome de uma tag ou uma caixa de pesquisa.
- Para selecionar um branch usando o nome dele, selecione Branch e clique no nome.
- Para selecionar uma ramificação usando um nome de tag, selecione Tag e clique no nome da tag.
- Para selecionar um branch usando um código de commit, selecione Commit e clique no código.
- Para pesquisar uma ramificação, confirmação ou tag, selecione o item correspondente e digite um termo na caixa de pesquisa.
Como trabalhar com arquivos
Quando você seleciona um repositório na tela principal, a tela muda para mostrar uma visualização dele. Se um arquivo README existir, o conteúdo dele vai aparecer no painel de arquivos, localizado no lado direito da tela. Caso contrário, uma lista de arquivos e pastas do repositório será exibida. No lado esquerdo da tela, há uma visualização em árvore dos arquivos e pastas do repositório. Você pode usar essa árvore para navegar e abrir arquivos específicos.
Ao visualizar um repositório, a barra de ferramentas de breadcrumbs agora tem três componentes:
- Um menu Repositório, em que você pode selecionar diferentes repositórios
- Um menu Branch/Commit/Tag, em que você pode selecionar ramificações, tags ou confirmações específicas.
- Uma caixa Caminho do arquivo, que mostra o nome do arquivo ou da pasta atual e o caminho correspondente
Abrir um arquivo
Para abrir um arquivo, navegue até o diretório dele e selecione-o. A visualização do repositório é atualizada para mostrar o conteúdo do arquivo no painel de arquivos e o local dele no repositório no painel de árvore.
Conferir alterações de arquivo
Para conferir as mudanças nos arquivos:
- Na visualização do repositório, selecione o arquivo.
- Clique em ÚLTIMA MODIFICAÇÃO DE, localizado no canto superior direito.
O painel de arquivos é atualizado para mostrar quem fez as alterações no arquivo e quando.
Conferir o histórico de alterações
Para conferir o histórico de alterações de um arquivo:
- Na visualização do repositório, selecione o arquivo.
- Clique em HISTÓRICO, no canto superior direito. O painel Histórico de alterações aparece mostrando as confirmações para esse arquivo.
Conferir análises de código
Para análises de código no Gerrit, abra a ferramenta diretamente no painel "Histórico de alterações".
Para conferir a análise de código de um arquivo:
- Na visualização do repositório, selecione o arquivo.
- Clique em HISTÓRICO, no canto superior direito. O painel "Histórico de alterações" aparece, mostrando as confirmações para esse arquivo.
- Passe o cursor sobre uma confirmação. Um botão Mais (três pontos verticais) vai aparecer.
- Clique no botão Mais.
- Selecione Ver análise de código.
A ferramenta Gerrit Code Review é aberta em uma nova janela do navegador.
Abrir um arquivo em uma confirmação específica
Para abrir um arquivo em um commit específico:
- Na visualização do repositório, selecione o arquivo.
- Clique em HISTÓRICO, no canto superior direito. O painel "Histórico de alterações" aparece, mostrando as confirmações para esse arquivo.
- Passe o cursor sobre uma confirmação. O botão VIEW (visualizar) vai aparecer.
- Clique no botão VIEW.
Comparar um arquivo com uma confirmação diferente
Para comparar um arquivo em uma confirmação diferente:
- Na visualização do repositório, selecione o arquivo. Para comparar dois comitês diferentes, primeiro abra o arquivo nesse commit.
- Passe o cursor sobre uma confirmação. O botão DIFF vai aparecer.
- Clique no botão DIFF.
O painel de arquivos é atualizado para mostrar uma comparação lado a lado entre os dois arquivos. O mais antigo dos dois registros sempre fica à esquerda.
No painel "Histórico de alterações", as duas confirmações são destacadas, e um rótulo indica se a confirmação é exibida à esquerda ou à direita.
Para mudar um dos arquivos, passe o cursor sobre a confirmação no painel "Histórico de alterações". Em seguida, clique no botão Esquerda ou Direita para abrir o commit no lado esquerdo ou direito da diferença.
Como procurar referências cruzadas
Outra maneira de navegar nos repositórios de origem é usando referências cruzadas. Essas referências aparecem automaticamente como hiperlinks em um determinado arquivo de origem.
Para facilitar a identificação das referências cruzadas, clique em Referências cruzadas, localizado no canto superior direito. Essa opção exibe um sublinhado abaixo de todas as referências cruzadas em um arquivo.
Observação:se a opção Referências cruzadas estiver esmaecida, isso indica que as referências cruzadas não estão disponíveis para esse arquivo.
Clique em uma referência cruzada para abrir o painel de referência cruzada. Esse painel contém duas seções:
- Uma seção Definition, que lista os arquivos que definem a referência.
- Uma seção References, que lista os arquivos em que a referência também aparece
Ambas as seções mostram o nome do arquivo e as linhas que contêm a referência. Para abrir um arquivo no painel de referência cruzada, clique na entrada do número da linha. O arquivo aparece em uma nova seção do painel, permitindo que você continue a navegar pelo arquivo enquanto mantém o arquivo original visível.
Você pode continuar navegando pelas referências cruzadas usando o painel "Referência cruzada", assim como no painel "Arquivo". Quando você faz isso, o painel mostra um rastro de migas, que pode ser usado para navegar entre diferentes referências cruzadas.
Como pesquisar o código
É possível pesquisar arquivos específicos ou snippets de código usando a caixa de pesquisa localizada na parte de cima da tela. As pesquisas são sempre feitas na ramificação padrão.
Todas as pesquisas usam expressões regulares RE2 (em inglês) por padrão. Se você não quiser usar expressões regulares, coloque sua pesquisa entre aspas duplas (").
Observação:para pesquisar rapidamente um arquivo específico, adicione um barra invertida antes do ponto ou inclua o nome do arquivo inteiro entre aspas.
foo\.java
"foo.java"
Você pode refinar sua pesquisa usando os filtros a seguir.
| Filtrar | Outras opções | Descrição | Exemplo |
|---|---|---|---|
| lang: | idioma: | Fazer uma correspondência exata pelo idioma do arquivo. | lang:java test |
| arquivo: | filepath: path: f: |
||
| case:yes | Pesquise com diferenciação de maiúsculas e minúsculas. Por padrão, as pesquisas não diferenciam maiúsculas de minúsculas. | case:yes Hello World | |
| class: | Pesquise por um nome de classe. | class:MainClass | |
| function: | func: | Pesquise por um nome de função. | function:print |
| - | Nega o termo da pesquisa. | hello -world | |
| \ | Caractere de escape dos caracteres especiais, como ., \ ou (. | run\(\) | |
| "[term]" | Faça uma pesquisa literal. | "class:main" |
Suporte adicional
Para informar um problema, clique no botão Feedback que aparece no canto superior direito da tela e insira seu feedback no formulário fornecido.