Como trabalhar com referências cruzadas

As referências cruzadas permitem explorar conexões entre símbolos na base de código.

Quando configurado, 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, há referências cruzadas para pelo menos um idioma nesse repositório. Observe que nem todos os repositórios com marcas de seleção têm referências cruzadas para o mesmo conjunto de idiomas.

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

Acessar uma definição

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

Como encontrar usos e usar o painel de referência cruzada

Clicar no lugar em que um símbolo é definido abre o painel de referência cruzada que mostra uma lista de locais em que o símbolo é usado. Clicar em uma referência 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 mais informações sobre como ativar 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ência cruzada permite explorar o contexto das referências. Na seção da hierarquia de chamadas, clicar na twistie ao lado do número da linha mostra o autor da chamada dessa referência. Isso permite explorar a hierarquia de chamadas para cima.

Ver os arquivos gerados

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

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

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ência cruzada abre uma visualização do arquivo ao lado do painel de referência cruzada. Quando o painel de visualização está desativado, clicar no painel de referência cruzada abre a referência na janela de código principal.

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

Como ativar a visualização