Cómo trabajar con referencias cruzadas

Las referencias cruzadas te permiten explorar las conexiones entre los símbolos de la base de código.

Cuando se configuran, las referencias cruzadas las proporciona kythe. Para determinar si un repositorio en particular tiene referencias cruzadas configuradas, consulta la columna de referencias cruzadas en la página del proyecto. Si hay una marca de verificación, significa que hay referencias cruzadas para al menos un idioma en ese repositorio. Ten en cuenta que no todos los repositorios con marcas de verificación tienen referencias cruzadas para el mismo conjunto de idiomas.

Ejemplo de cómo se muestra un repositorio con referencias cruzadas disponibles en la página del proyecto

Cómo ir a una definición

Cuando las referencias cruzadas están habilitadas, los símbolos se convierten en vínculos. Si haces clic en el uso de un símbolo, se navega al lugar del código en el que se define el símbolo. Consulta Configuración de referencias cruzadas para obtener información sobre cómo habilitar el subrayado de los símbolos en los que se puede hacer clic.

Cómo encontrar usos y usar el panel de referencias cruzadas

Si haces clic en el lugar donde se define un símbolo, se abre el panel de referencias cruzadas, que te muestra una lista de los lugares donde se usa el símbolo. Cuando haces clic en una referencia, se abre un panel de vista previa o se muestra el uso en la ventana principal para que puedas ir a ese uso. Consulta Configuración de referencias cruzadas para obtener información sobre cómo activar o desactivar este comportamiento. Cuando se hace clic en un vínculo del panel de referencias cruzadas, el navegador de código salta a la versión del archivo en la que se crearon las referencias cruzadas.

Cómo usar la jerarquía de llamadas

La sección de jerarquía de llamadas del panel de referencias cruzadas te permite explorar el contexto de las referencias. En la sección de jerarquía de llamadas, si haces clic en el ícono de expansión junto al número de línea, se muestra la persona que llama de esa referencia. Esto te permite explorar la jerarquía de llamadas hacia arriba.

Cómo ver los archivos generados

En los repositorios con referencias cruzadas, puedes ver artefactos generados a partir de la compilación que no están presentes en el repositorio; por ejemplo, archivos .cc y .h creados a partir de archivos .proto. También se pueden ver algunos archivos descargados como parte del proceso de compilación.

Algunos vínculos del panel de referencias cruzadas te dirigen a archivos generados. Puedes navegar a estos archivos generados desde la vista del panel de directorios.

Configuración de referencias cruzadas

Puedes activar o desactivar la ventana de vista previa de referencias cruzadas. Cuando el panel de vista previa está activado, si haces clic en el panel de referencias cruzadas, se abrirá una vista previa del archivo junto a este panel. Cuando el panel de vista previa está desactivado, si haces clic en el panel de referencias cruzadas, se abrirá la referencia en la ventana principal de código.

También puedes activar o desactivar el subrayado de las referencias cruzadas.

Cómo activar o desactivar la vista previa