Descripción general del producto
La interfaz de búsqueda de código y navegación de código fuente de Bazel es una herramienta basada en la Web para explorar repositorios de código fuente de Bazel. Puedes usar estas características para navegar entre diferentes repositorios, ramas y archivos. También puedes ver la información del historial, las diferencias y las culpas.
Cómo comenzar
Para acceder a la búsqueda de código y a la interfaz de navegación de origen, abre https://source.bazel.build en tu navegador web.
Aparecerá la pantalla principal. Esta pantalla contiene los siguientes componentes:
La barra de herramientas de la ruta de navegación. Esta barra de herramientas muestra tu ubicación actual en el repositorio y te permite moverte rápidamente a otra ubicación, como otro repositorio o alguna otra ubicación dentro de un repositorio, como un archivo, una rama o una confirmación.
Una lista de repositorios que puedes explorar.
En la parte superior de la pantalla hay un cuadro de búsqueda. Puedes usar este cuadro para buscar archivos y códigos específicos.
Trabaja con repositorios
Abre un repositorio
Para abrir un repositorio, haz clic en su nombre en la pantalla principal.
Como alternativa, puedes usar la barra de herramientas de la ruta de navegación para buscar un repositorio específico. Esta barra de herramientas muestra tu ubicación actual en el repositorio y te permite moverte rápidamente a otra ubicación, como otro repositorio o alguna otra ubicación dentro de un repositorio, como un archivo, una rama o una confirmación.
Cambiar repositorios
Para cambiar a un repositorio diferente, selecciona el repositorio en la barra de herramientas de la ruta de navegación.
Ve un repositorio en una confirmación específica
Para ver un repositorio en una confirmación específica, sigue estos pasos:
- En la vista del repositorio, selecciona el archivo.
- Desde la barra de herramientas de la ruta de navegación, abre el menú Rama.
- En el submenú que aparece, haga clic en Confirmar.
- Selecciona la confirmación que deseas ver.
La interfaz ahora muestra el repositorio tal como existía en esa confirmación.
Abre una rama, confirmación o etiqueta
De forma predeterminada, la búsqueda de código y la interfaz de navegación de origen abre un repositorio a la rama predeterminada. Para abrir una rama diferente, en la barra de herramientas de la ruta de navegación, haz clic en el menú Rama/Confirmación/Etiqueta. Se abrirá un submenú que te permitirá seleccionar una rama con el nombre de una rama, un nombre de etiqueta o un cuadro de búsqueda.
- Para seleccionar una rama con un nombre de rama, selecciona Rama y haz clic en el nombre de la rama.
- Para seleccionar una rama con un nombre de etiqueta, selecciona Etiqueta y haz clic en el nombre de la etiqueta.
- Para seleccionar una rama cuando usas un ID de confirmación, selecciona Confirmación y haz clic en el ID de confirmación.
- Para buscar una rama, confirmación o etiqueta, selecciona el elemento correspondiente y escribe un término de búsqueda en el cuadro de búsqueda.
Trabaja con archivos
Cuando seleccionas un repositorio de la pantalla principal, la pantalla cambia para mostrar una vista de ese repositorio. Si existe un archivo README, su contenido aparecerá en el panel del archivo, que se encuentra en el lado derecho de la pantalla. De lo contrario, aparecerá una lista de los archivos y carpetas del repositorio. En la parte izquierda de la pantalla, hay una vista de árbol de los archivos y carpetas del repositorio. Puedes usar este árbol para explorar y abrir archivos específicos.
Ten en cuenta que, cuando veas un repositorio, la barra de herramientas de la ruta de navegación ahora tiene tres componentes:
- El menú Repositorio, en el que puedes seleccionar diferentes repositorios
- Un menú de Rama/Confirmación/Etiqueta, desde el que puedes seleccionar ramas, etiquetas o confirmaciones específicas
- Un cuadro de Ruta de acceso del archivo, que muestra el nombre del archivo o la carpeta actual y su ruta correspondiente
Cómo abrir un archivo
Para abrir un archivo, navega a su directorio y selecciónalo. La vista del repositorio se actualiza para mostrar el contenido del archivo en el panel de archivos y su ubicación en el panel de árbol.
Ver cambios en el archivo
Para ver los cambios en el archivo:
- En la vista del repositorio, selecciona el archivo.
- Haz clic en Modificado por última vez por, ubicado en la esquina superior derecha.
El panel del archivo se actualiza para mostrar quién realizó cambios en el archivo y cuándo.
Consulta el historial de cambios
Para ver el historial de cambios de un archivo:
- En la vista del repositorio, selecciona el archivo.
- Haz clic en HISTORIAL, que se encuentra en la esquina superior derecha. Aparecerá el panel Historial de cambios con las confirmaciones de este archivo.
Ver las revisiones de código
Para las revisiones de código de Gerrit, puede abrir la herramienta directamente desde el panel Historial de cambios.
Para ver la revisión de código de un archivo:
- En la vista del repositorio, selecciona el archivo.
- Haz clic en HISTORIAL, que se encuentra en la esquina superior derecha. Aparecerá el panel de historial de cambios, en el que se muestran las confirmaciones de este archivo.
- Coloca el cursor sobre una confirmación. Aparecerá el botón Más (tres puntos verticales).
- Haz clic en el botón Más.
- Selecciona Ver revisión de código.
Se abrirá la herramienta Gerrit Code Review en una nueva ventana del navegador.
Abre un archivo en una confirmación específica
Para abrir un archivo en una confirmación específica, sigue estos pasos:
- En la vista del repositorio, selecciona el archivo.
- Haz clic en HISTORIAL, que se encuentra en la esquina superior derecha. Aparecerá el panel de historial de cambios, en el que se muestran las confirmaciones de este archivo.
- Coloca el cursor sobre una confirmación. Aparecerá el botón VER.
- Haga clic en el botón VER.
Compara un archivo con una confirmación diferente
Para comparar un archivo en una confirmación diferente, sigue estos pasos:
- En la vista del repositorio, selecciona el archivo. Para comparar dos confirmaciones diferentes, primero abre el archivo en esa confirmación.
- Coloca el cursor sobre una confirmación. Aparecerá el botón DIFF.
- Haz clic en el botón DIFF.
El panel de archivos se actualiza para mostrar una comparación en paralelo entre los dos archivos. La más antigua de las dos confirmaciones siempre está a la izquierda.
En el panel Historial de cambios, ambas confirmaciones están destacadas y una etiqueta indica si la confirmación se muestra a la izquierda o a la derecha.
Para cambiar cualquiera de los archivos, desplázate sobre la confirmación en el panel Historial de cambios. Luego, haz clic en el botón Izquierda o Derecha para abrir la confirmación en el lado izquierdo o derecho de la diferencia.
Explora referencias cruzadas
Otra forma de explorar los repositorios de código fuente es mediante el uso de referencias cruzadas. Estas referencias aparecen automáticamente como hipervínculos en un archivo de origen determinado.
Para que las referencias cruzadas sean más fáciles de identificar, haz clic en Referencias cruzadas, en la esquina superior derecha. Esta opción muestra un subrayado debajo de todas las referencias cruzadas en un archivo.
Nota: Si las referencias cruzadas están inhabilitadas, esto indica que las referencias cruzadas no están disponibles para ese archivo.
Haz clic en una referencia cruzada para abrir el panel de referencia cruzada. Este panel contiene dos secciones:
- Una sección de Definición, que enumera los archivos que definen la referencia
- Una sección de References, que enumera los archivos en los que también aparece la referencia
Ambas secciones muestran el nombre del archivo, así como la línea o las líneas que contienen la referencia. Para abrir un archivo desde el panel de referencia cruzada, haz clic en la entrada del número de línea. El archivo aparecerá en una sección nueva del panel, lo que te permitirá seguir explorando el archivo sin perder el archivo original.
Puedes seguir explorando las referencias cruzadas con el panel de referencia cruzada, del mismo modo que en el panel Archivo. Cuando lo haces, el panel muestra un recorrido de ruta de navegación, que puedes usar para navegar entre diferentes referencias cruzadas.
Buscando código
Puedes buscar archivos específicos o fragmentos de código con el cuadro de búsqueda ubicado en la parte superior de la pantalla. Las búsquedas siempre van en la rama predeterminada.
Todas las búsquedas usan expresiones regulares RE2 de forma predeterminada. Si no deseas usar expresiones regulares, incluye tu búsqueda entre comillas dobles (").
Nota: Para buscar rápidamente un archivo específico, agrega una barra invertida al comienzo del período o escribe el nombre completo del archivo entre comillas.
foo\.java
"foo.java"
Puedes definir mejor tu búsqueda mediante los siguientes filtros.
| Filtro | Otras opciones | Descripción | Ejemplo |
|---|---|---|---|
| lang: | idioma: | Realice una concordancia exacta por idioma del archivo. | Prueba lang:java |
| file: | filepath: path: f: |
||
| case:yes | Hace que la búsqueda distinga mayúsculas y minúsculas. De forma predeterminada, las búsquedas no distinguen mayúsculas de minúsculas. | case:yes Hello World | |
| class: | Busca un nombre de clase. | clase:MainClass | |
| function: | func: | Busca un nombre de función. | función:imprimir |
| - | Nega el término de la búsqueda. | hola, mundo | |
| \ | Usa caracteres de escape como caracteres especiales, como ., \ o (. | ejecución\(\) | |
| “[término]” | Realiza una búsqueda literal. | "clase:main" |
Asistencia adicional
Para informar un problema, haz clic en el botón Comentarios que aparece en la esquina superior derecha de la pantalla e ingresa los comentarios en el formulario proporcionado.