Descripción general
El editor de código fuente de Git (ci.android.com/edit) es una herramienta basada en navegador para editar archivos en el Proyecto de código abierto de Android (AOSP) y cargar cambios en Gerrit. Está pensado 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 . Debe estar familiarizado con el proceso completo de envío de cambios a AOSP usando Git, Repo y Gerrit antes de usar el editor de código fuente de Git.
Cuando editas un archivo usando el editor de código fuente de Git, todo el trabajo se realiza en tu máquina local, hasta que cargas los cambios para crear una lista de cambios de Gerrit.
Acceso
- Cargue Git Source Editor en un navegador.
Haga clic en Iniciar sesión para iniciar sesión en su cuenta.
Figura 1. Botón de inicio de sesión
Editar archivos y cambios
Git Source Editor tiene estos flujos de trabajo principales:
- Edita uno o más archivos de tu elección, en la rama que elijas.
- Editar un cambio. Cuando editas un cambio, el resultado depende de quién creó el cambio:
- Si creó el cambio, las ediciones de su Git Source Editor se parchean en el cambio como un nuevo conjunto de parches.
- Si alguien más creó el cambio, las ediciones de su Git Source Editor crean un nuevo cambio de su propiedad, basado en el cambio que cargó.
Carga lo que quieras editar
Inicie una sesión de edición cargando un archivo o un cambio.
Cargar archivos
Ingrese la URL del archivo que desea editar en el cuadro archivo/cambiar ruta en la parte superior de la página.
Ruta de archivo de muestra: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md
Haga clic en Cargar archivo o cambiar .
Figura 2. Cargando un archivo o cambio
El archivo se carga en el panel del editor. El panel de navegación a la izquierda del panel del editor es un explorador de archivos, que abre el repositorio con su archivo precargado.
Figura 3. Un archivo cargado en el panel de edición
Puede utilizar el panel de navegación para abrir más archivos dentro del mismo repositorio. Si abre varios archivos, cada archivo aparece como una pestaña en la fila encima del panel de edición. Haga clic en una pestaña para abrir ese archivo en el panel de edición.
Figura 4. Pestañas para archivos cargados
Cargar un cambio
Navegue hasta el cambio que desea editar ingresando la URL de una lista de cambios de Gerrit en el cuadro de ruta de archivo/cambio en la parte superior de la página (consulte la Figura 2).
Enlace de cambio de muestra: https://android-review.googlesource.com/c/platform/build/soong/+/1284176
Los archivos del cambio se abren en el panel de edición (consulte la Figura 3).
Si el cambio incluye varios archivos, cada archivo aparece como una pestaña en la fila encima del panel de edición (consulte la Figura 4). Haga clic en una pestaña para abrir ese archivo en el panel de edición.
Haz tus ediciones
Edite archivos usando el panel de edición de texto. Los archivos que edita aparecen en la lista de cambios pendientes debajo del panel de edición. Si cierra accidentalmente la pestaña de un archivo con ediciones, puede volver a abrir el archivo con las ediciones intactas haciendo clic en su nombre en la lista de cambios pendientes.
Presentar cambios
Crea y publica su cambio en Gerrit en Git Source Editor. Luego realiza un seguimiento de la aprobación del cambio en Gerrit.
Crear y publicar los cambios.
Siga este procedimiento para crear y publicar los cambios que ha realizado.
Haga clic en el botón correspondiente:
- Haga clic en Crear cambio si está creando un nuevo cambio.
- Haga clic en Actualizar cambio si está actualizando un cambio existente.
Se abre un cuadro de diálogo.
Figura 5. Cuadro de diálogo Crear cambio
Ingrese una descripción del cambio, que se convertirá en la descripción del cambio en Gerrit. Esta descripción es obligatoria. Si está editando un cambio existente, puede editar su descripción si lo desea.
Opcionalmente, desactive o seleccione la casilla de verificación Publicar al crear .
Esta casilla está seleccionada de forma predeterminada.
Si esta casilla está seleccionada cuando crea el cambio, el cambio se publica inmediatamente en Gerrit. Si la casilla no está seleccionada, el cambio se carga en Gerrit pero no se publica.
Haga clic en Crear .
El cambio se carga en Gerrit. Si seleccionó la casilla de verificación Publicar al crear , el cambio también se publica en Gerrit. El cambio está vinculado en una notificación en la parte superior de la pantalla.
Figura 6. Notificación de cambio creado
Seguimiento de la aprobación de cambios en Gerrit
Realice un seguimiento del estado de envío de cambios directamente en Gerrit, como lo haría con cualquier otro cambio.
Figura 7. Seguimiento del estado de envío de cambios en Gerrit
Ver diferencias de archivos
Seleccione la casilla de verificación Diff debajo del panel de edición para ver las diferencias de las ediciones que realizó en el archivo que está activo en el panel de edición. Esto es útil al cambiar un archivo y al editar un cambio existente.
Figura 8. Visualización de diferencias de archivos
Revertir archivos
Puede revertir los cambios de un solo archivo o de todos los archivos en la lista de cambios pendientes. Ambas opciones de reversión revierten los cambios solo en Git Source Editor. NO actualizarán el cambio en Gerrit.
Revertir un solo archivo
Para revertir un solo archivo, haga clic en la X junto al nombre del archivo en la lista de cambios pendientes.
Figura 9. Sección de cambios pendientes
Revertir todos los archivos
Para revertir todos los archivos a la vez, haga clic en Revertir todos los archivos debajo del panel de edición.
Figura 10. Botón Revertir todos los archivos
Se abre un cuadro de diálogo emergente. Haga clic en Revertir todo para revertir los cambios en todos los archivos pendientes, o haga clic en Cancelar para conservar los cambios y continuar editando.
Figura 11. Cuadro de diálogo de confirmación de revertir todos los archivos
Edite una página directamente desde la búsqueda de código de Android
Puede abrir un archivo en Git Source Editor directamente desde la búsqueda de código de Android . Esto es útil si necesita localizar el archivo antes de editarlo.
Siga este procedimiento para editar un archivo directamente desde la búsqueda de código de Android.
En Android Code Search (cs.android.com), navegue hasta el archivo que le interesa editar.
Haz clic en Editar código .
Figura 12. Botón Editar código de búsqueda de código de Android
Git Source Editor se abre con el archivo preseleccionado para editar.
Seleccione la rama de Git en la que desea editar el archivo en la lista desplegable Seleccionar una rama de git y luego haga clic en Seleccionar rama .
Figura 13. Seleccionar una rama de Git para editar
El archivo se abre en el panel de edición.
Continúe editando como se describe en la sección Realizar sus ediciones .
Puede abrir archivos adicionales para editar como se describe en la sección Cargando archivos
Resolver conflictos
Para resolver conflictos:
En el Editor de código fuente, navegue hasta el cambio. Una vez cargado el cambio, los archivos en conflicto se enumeran en la parte inferior de la pantalla. Por ejemplo, la Figura 14 muestra que el archivo
Android.pbtiene un conflicto.
Figura 14. Conflicto del editor de código fuente
Haga clic en un archivo conflictivo. El archivo se carga y muestra bloques de contenido en conflicto en sucesión y dentro de los marcadores de Git (
<<<<<<<y>>>>>>>).
Figura 15. Marcadores de conflicto del editor de código fuente
Solucione el conflicto editando el archivo y eliminando manualmente los marcadores de conflicto alrededor del contenido que desea conservar. Además, elimine los marcadores de contenido y conflicto del contenido que no desea conservar.
Haga clic en Crear cambio para crear un nuevo cambio. Aparece el cuadro de diálogo Crear cambio.
Figura 16. Crear cambio
Escriba una descripción del cambio y haga clic en Crear .
Enviar comentarios
Usa el botón de error 
en la esquina superior derecha para proporcionar comentarios sobre Git Source Editor.