Como trabalhar com referências cruzadas

Com as referências cruzadas, é possível explorar conexões entre símbolos na base de código.

Quando configuradas, as referências cruzadas são fornecidas pelo kythe. Para determinar se um repositório específico tem referências cruzadas configuradas, consulte a coluna de referências cruzadas na página do projeto. Se houver uma marca de seleção, haverá referências cruzadas para pelo menos um idioma nesse repositório. Nem todos os repositórios com marcas de seleção têm referências cruzadas para o mesmo conjunto de linguagens.

Exemplo de como um repositório com referências cruzadas disponíveis é mostrado na página do projeto

Ir para uma definição

Quando as referências cruzadas estão ativadas, os símbolos se tornam links. Ao clicar em um uso de símbolo, você navega até o lugar no código em que ele é definido. Consulte Configurações de referência cruzada para informações sobre como ativar o sublinhado para símbolos clicáveis.

Encontrar usos e usar o painel de referências cruzadas

Ao clicar no local em que um símbolo é definido, o painel de referência cruzada é aberto e mostra uma lista de lugares em que o símbolo é usado. Ao clicar em uma referência, você pula para esse uso abrindo um painel de visualização ou mostrando o uso na janela principal. Consulte Configurações de referência cruzada para saber como ativar ou desativar esse comportamento. Quando um link no painel de referência cruzada é clicado, o navegador de código pula para a versão do arquivo em que as referências cruzadas foram criadas.

Como usar a hierarquia de chamadas

A seção de hierarquia de chamadas do painel de referências cruzadas permite explorar o contexto das referências. Na seção de hierarquia de chamadas, clique no ícone de expansão ao lado do número da linha para mostrar o autor da chamada dessa referência. Isso permite que você explore a hierarquia de chamadas para cima.

Como ver os arquivos gerados

Em repositórios com referências cruzadas, é possível ver artefatos gerados do build que não estão presentes no repositório. Por exemplo, arquivos .cc e .h criados com arquivos proto. Alguns arquivos baixados como parte do processo de build também ficam visíveis.

Alguns links do painel de referências cruzadas levam a arquivos gerados. Você pode navegar até esses arquivos gerados na visualização do painel de diretórios.

Configurações de referência cruzada

É possível alternar a janela de visualização de referências cruzadas. Quando o painel de visualização está ativado, clicar no painel de referências cruzadas abre uma prévia do arquivo ao lado dele. Quando o painel de visualização está desativado, clicar no painel de referência cruzada abre a referência na janela principal de código.

Também é possível ativar e desativar o sublinhado das referências cruzadas.

Como ativar ou desativar a prévia