Git Source Editor

Descripción general

Git Source Editor (ci.android.com/edit) es una herramienta basada en un navegador para editar archivos en el Proyecto de código abierto de Android (AOSP) y subir cambios a Gerrit. Está diseñada para realizar cambios menores en una pequeña cantidad de archivos y proporciona un flujo de trabajo más rápido que descargar el árbol de fuentes de Android. Para poder usar Git Source Editor, debes estar al tanto del proceso completo de envío de cambios a AOSP mediante Git, Repo y Gerrit.

Cuando editas un archivo con Git Source Editor, todo el trabajo se lleva a cabo en tu máquina local, hasta que subes cambios para crear una lista de cambios de Gerrit.

Cómo acceder

  1. Carga Git Source Editor en un navegador.
  2. Haz clic en Log in para acceder a tu cuenta.

    Botón de acceso

    Figura 1: Botón de acceso

Cómo editar archivos y cambios

Git Source Editor incluye estos flujos de trabajo principales:

  • En la rama que selecciones, edita uno o más de los archivos que quieras.
  • Edita un cambio. Cuando edites un cambio, el resultado dependerá de quién lo haya creado:
    • Si tú creaste el cambio, se incluirán las ediciones de Git Source Editor en el cambio como un nuevo conjunto de parches.
    • Si otra persona creó el cambio, tus ediciones de Git Source Editor crearán un nuevo cambio de tu propiedad, según el cambio que hayas cargado.

Cómo cargar lo que quieres editar

Inicia una sesión de edición cargando un archivo o un cambio.

Cómo cargar archivos

  1. Ingresa la URL del archivo que quieras editar en el cuadro file/change path (ruta de archivo/cambio), ubicado en la parte superior de la página.

    Ruta de acceso del archivo de muestra: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md

  2. Haz clic en Load file or change.

    Cómo cargar un archivo o un cambio

    Figura 2: Cómo cargar un archivo o un cambio

    El archivo se carga en el panel del editor. El panel de navegación que se encuentra a la izquierda del panel del editor es un navegador de archivos, que abre el repositorio con tu archivo precargado.

    Un archivo cargado en el panel de edición

    Figura 3: Un archivo cargado en el panel de edición

Puedes usar el panel de navegación para abrir más archivos dentro del mismo repositorio. Si abres varios archivos, cada uno aparecerá como una pestaña en la fila que se encuentra encima del panel de edición. Haz clic en una pestaña para abrir ese archivo en el panel de edición.

Pestañas para archivos cargados

Figura 4: Pestañas para archivos cargados

Cómo cargar un cambio

En la parte superior de la página, ingresa la URL de una lista de cambios de Gerrit en el cuadro file/change path (ruta de archivo/cambio) para navegar hasta el cambio que quieras editar (consulta la figura 2).

Ejemplo de vínculo de cambio: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

Se abrirán los archivos del cambio en el panel de edición (consulta la figura 3).

Si el cambio incluye varios archivos, cada uno aparecerá como una pestaña en la fila que se encuentra encima del panel de edición (consulta la figura 4). Haz clic en una pestaña para abrir ese archivo en el panel de edición.

Cómo realizar ediciones

Edita archivos con el panel de edición de texto. Los archivos que edites aparecerán en la lista Pending changes (cambios pendientes), debajo del panel de edición. Si cierras accidentalmente la pestaña de un archivo con ediciones, puedes volver a abrir el archivo con las modificaciones intactas haciendo clic en su nombre, en la lista de cambios pendientes.

Cómo enviar cambios

Crea tu cambio y publícalo en Gerrit desde Git Source Editor. Luego, haz un seguimiento de la aprobación del cambio en Gerrit.

Cómo crear y publicar cambios

Sigue este procedimiento para crear y publicar los cambios que realices.

  1. Haz clic en el botón correspondiente:

    • Si quieres crear un nuevo cambio, haz clic en Create change (crear cambio).
    • Para actualizar uno existente, haz clic en Update change (actualizar cambio).

    Se abrirá un cuadro de diálogo.

    Cuadro de diálogo Create Change

    Figura 5: Cuadro de diálogo Create Change

  2. Ingresa una descripción del cambio, que se convertirá en la descripción del cambio en Gerrit. La descripción es obligatoria. Si quieres editar un cambio existente, puedes modificar su descripción.

  3. De manera opcional, marca o desmarca la casilla de verificación Publish on create (publicar al crear).

    Esa casilla está seleccionada de forma predeterminada.

    Si sigue seleccionada cuando crees el cambio, este se publicará inmediatamente en Gerrit. De lo contrario, se subirá el cambio a Gerrit, pero no se publicará.

  4. Haz clic en Create (crear).

    Se subirá el cambio a Gerrit. Si seleccionaste la casilla de verificación Publish on create, también se publicará el cambio en Gerrit. El cambio se vincula en una notificación, en la parte superior de la pantalla.

    Cambia la notificación creada

    Figura 6: Cambia la notificación creada

Cómo hacer un seguimiento de la aprobación de cambios en Gerrit

Realiza un seguimiento del estado del envío del cambio directamente en Gerrit como lo harías con cualquier otro cambio.

Cómo hacer un seguimiento del estado del envío de un cambio en Gerrit

Figura 7: Cómo hacer un seguimiento del estado del envío de un cambio en Gerrit

Cómo ver las diferencias del archivo

Selecciona la casilla de verificación Diff (diferencias) debajo del panel de edición para ver las diferencias de las ediciones que hiciste en el archivo que está abierto en el panel de edición. Esto es útil a la hora de modificar un archivo o editar un cambio existente.

Cómo ver las diferencias del archivo

Figura 8: Cómo ver las diferencias del archivo

Cómo revertir cambios en archivos

Puedes revertir cambios de un solo archivo o de todos los archivos de la lista de cambios pendientes. Ambas opciones revierten los cambios solo en Git Source Editor. NO actualizarán el cambio en Gerrit.

Cómo revertir cambios en un solo archivo

Para revertir los cambios en un solo archivo, haz clic en la X que aparece junto al nombre del archivo de la lista de cambios pendientes.

Sección Pending changes (cambios pendientes)

Figura 9: Sección Pending changes

Cómo revertir cambios en todos los archivos

Para revertir los cambios en todos los archivos a la vez, haz clic en Revert all files (revertir cambios en todos los archivos) debajo del panel de edición.

Botón Revert all files

Figura 10: Botón Revert all files

Se abrirá un cuadro de diálogo emergente. Haz clic en Revert all (revertir todo) para revertir los cambios realizados en todos los archivos pendientes o Cancel (cancelar) para conservar los cambios y seguir editando.

Cuadro de diálogo para confirmar la reversión de los cambios de todos los archivos

Figura 11: Cuadro de diálogo para confirmar la reversión de los cambios de todos los archivos

Puedes abrir un archivo en Git Source Editor directamente desde Android Code Search. Esto es útil si necesitas ubicar el archivo antes de editarlo.

Sigue este procedimiento para editar un archivo directamente desde Android Code Search.

  1. En Android Code Search (cs.android.com), navega hasta el archivo que quieras editar.

  2. Haz clic en Edit code (editar código).

    Botón Edit code de Android Code Search

    Figura 12: Botón Edit code de Android Code Search

    Git Source Editor se abre con el archivo preseleccionado para edición.

  3. Selecciona la rama de Git en la que quieras editar el archivo de la lista desplegable en Select a git branch (seleccionar rama de Git) y, luego, haz clic en Pick branch (elegir rama).

    Cómo seleccionar una rama de Git para editar

    Figura 13: Cómo seleccionar una rama de Git para editar

    Se abrirá el archivo en el panel de edición.

  4. Continúa editando como se describe en la sección Cómo realizar ediciones.

  5. Puedes abrir archivos adicionales para editarlos como se describe en la sección Cómo cargar archivos.

Cómo resolver conflictos

Para resolver conflictos, haz lo siguiente:

  1. En Source Editor, ve al cambio. Una vez cargado el cambio, los archivos que presentan problemas se enumeran en la parte inferior de la pantalla. Por ejemplo, en la figura 14, se muestra que el archivo Android.pb presenta un problema.

    Problemas con Source Editor

    Figura 14: Problemas con Source Editor

  2. Haz clic en un archivo que presenta el problema. El archivo se carga y muestra bloques de contenido en conflicto en sucesión y dentro de los marcadores de Git (<<<<<<< y >>>>>>>).

    Marcadores de problemas

    Figura 15: Marcadores de problemas de Source Editor

  3. Para corregir el problema, edita el archivo y quita de forma manual los marcadores de problemas alrededor del contenido que quieras conservar. También, quita el contenido y los marcadores de problemas que no quieras conservar.

  4. Haz clic en Create change (crear cambio) para crear un nuevo cambio. Aparecerá el diálogo Create change.

    Crear cambio

    Figura 16: Crear cambio

  5. Escribe una descripción del cambio y haz clic en Create (crear).

Cómo enviar comentarios

Usa el botón de error Imagen del botón de error ubicado en la esquina superior derecha para enviar comentarios sobre Git Source Editor.