Visão geral do produto
A interface de pesquisa e navegação de código-fonte do Bazel é uma ferramenta baseada na Web para navegar por 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 ver o histórico, as diferenças e as informações sobre os culpados.
Como começar
Para acessar a interface de pesquisa de código e navegação de origem, abra https://source.bazel.build no navegador da Web.
A tela principal será exibida. Essa tela contém os seguintes componentes:
A barra de ferramentas de navegação estrutural. 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 em que você pode navegar.
Na parte superior 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.
Também é possível usar a barra de ferramentas “Navegação estrutural” 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.
Alternar repositórios
Para alternar para um repositório diferente, selecione o repositório na barra de ferramentas “Navegação estrutural”.
Ver um repositório em uma confirmação específica
Para ver 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 Ramificação.
- No submenu exibido, clique em Confirmar.
- Selecione a confirmação que você quer ver.
A interface agora mostra o repositório como ele existia naquela confirmação.
Abrir uma ramificação, confirmação ou tag
Por padrão, a interface de pesquisa de código e navegação de origem abre um repositório para a ramificação padrão. Para abrir um branch diferente, clique no menu Branch/Commit/Tag na barra de ferramentas “Breadcrumb”. Um submenu é aberto, permitindo que você selecione uma ramificação usando um nome de ramificação, um nome de tag ou em uma caixa de pesquisa.
- Para selecionar um branch usando o nome dele, selecione Branch e clique no nome.
- Para selecionar um branch usando um nome de tag, selecione Tag e clique no nome.
- 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 exibir uma visualização desse repositório. 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 procurar e abrir arquivos específicos.
Observe que, ao visualizar um repositório, a barra de ferramentas “Navegação estrutural” agora tem três componentes:
- Um menu Repository, em que é possível selecionar diferentes repositórios
- Um menu Branch/Commit/Tag, em que é possível selecionar branches, tags ou confirmações específicas
- Uma caixa File path, que mostra o nome do arquivo ou da pasta atual e o caminho correspondente.
Abrir um arquivo
Para abrir um arquivo, navegue até seu diretório 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 da árvore.
Conferir mudanças no arquivo
Para visualizar as alterações no arquivo:
- 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 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, localizado no canto superior direito. O painel Histórico de alterações será exibido, mostrando as confirmações do arquivo.
Ver revisões de código
Para revisões de código Gerrit, você pode abrir a ferramenta diretamente no painel “Histórico de alterações”.
Para ver a revisão de código de um arquivo:
- Na visualização do repositório, selecione o arquivo.
- Clique em HISTÓRICO, localizado no canto superior direito. O painel “Histórico de alterações” será exibido, mostrando as confirmações desse arquivo.
- Passe o cursor sobre uma confirmação. O botão Mais (três pontos verticais) será exibido.
- Clique no botão Mais.
- Selecione Visualizar revisão de código.
A ferramenta de revisão de código Gerrit é aberta em uma nova janela do navegador.
Abrir um arquivo em uma confirmação específica
Para abrir um arquivo em uma confirmação específica:
- Na visualização do repositório, selecione o arquivo.
- Clique em HISTÓRICO, localizado no canto superior direito. O painel “Histórico de alterações” será exibido, mostrando as confirmações desse arquivo.
- Passe o cursor sobre uma confirmação. O botão VISUALIZAR será exibido.
- Clique no botão VISUALIZAR.
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 duas confirmações diferentes, primeiro abra o arquivo nessa confirmação.
- Passe o cursor sobre uma confirmação. Um botão DIFF será exibido.
- Clique no botão DIFF.
O painel de arquivos é atualizado para exibir uma comparação lado a lado entre os dois arquivos. A confirmação mais antiga das duas está sempre à esquerda.
No painel “Histórico de alterações”, as duas confirmações serão destacadas e um rótulo indica se ela será exibida à esquerda ou à direita.
Para alterar um dos arquivos, passe o cursor sobre a confirmação no painel “Histórico de alterações”. Em seguida, clique no botão Left ou Right para abrir a confirmação no lado esquerdo ou direito da diferença.
Como procurar referências cruzadas
Outra maneira de procurar 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, 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 Referência cruzada. Esse painel contém duas seções:
- Uma seção Definition, que lista o arquivo ou os arquivos que definem a referência.
- Uma seção References, que lista os arquivos em que a referência também é exibida
As duas seções exibem o nome do arquivo, além da linha ou linhas que contêm a referência. Para abrir um arquivo do painel Referência cruzada, clique na entrada do número de linha. O arquivo aparece em uma nova seção do painel, o que permite que você continue a procurar o arquivo, mantendo o original em visualização.
É possível continuar navegando por referências cruzadas usando o painel "Referência cruzada", da mesma forma que no painel "Arquivo". Ao fazer isso, o painel exibe uma trilha de navegação estrutural, que pode ser usada para navegar entre diferentes referências cruzadas.
Como pesquisar código
Pesquise arquivos ou snippets de código específicos 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 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 uma barra invertida na frente do ponto ou coloque o nome inteiro do arquivo 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: | Realizar uma correspondência exata por idioma do arquivo. | teste lang:java |
| file: | 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. | classe:MainClass | |
| function: | func: | Pesquise por um nome de função. | função:Imprimir |
| - | Nega o termo da pesquisa. | olá, mundo | |
| \ | Caractere de escape de caracteres especiais, como ., \ ou (. | run\(\) | |
| "[termo]" | Realize uma pesquisa literal. | "class:main" |
Suporte adicional
Para informar um problema, clique no botão Feedback no canto superior direito da tela e insira seu feedback no formulário fornecido.