Chromium Chronicle n.o 22: Conoce tus herramientas (depot)

Episodio 22: de Edward Lesmes en San Francisco, California (junio de 2021)
Episodios anteriores

Depot Tools es una colección de herramientas compilada en Git para simplificar el flujo de trabajo de los desarrolladores que contribuyen a la base de código de Chromium y los proyectos relacionados. Contiene herramientas para obtener el código, subir cambios para su revisión, mantener la confirmación de la compra actualizada y mucho más.

Obtén el código

Ejecuta fetch chromium en un directorio vacío. El comando fetch también se puede usar a fin de obtener el código para otros repositorios, como v8 o webrtc. Consulta fetch help para ver una lista completa.

Sube un cambio para su revisión

Cada CL corresponde a una sola rama en Git, por lo que debes comenzar con la ejecución de git new-branch <branch_name> para crear una rama nueva. Confirma todos los cambios que quieras en esta rama y ejecuta git cl upload cuando esté listo para la revisión.

git cl issue te informará a qué CL está asociada tu rama. Usa git cl issue <issue> para cambiarlo.

Mantén tu confirmación de la compra actualizada

Ejecuta git rebase-update de forma periódica para sincronizar las ramas locales con sus ascendentes y gclient sync para actualizar los repositorios de third_party y ejecutar hooks de compilación previa.

Administrar varias CL

  • git cl status mostrará las CL asociadas con las ramas locales y su estado (no enviado, LGTM, cerrado, etcétera).
  • git freeze y git thaw funcionan como git stash, pero debes realizar un seguimiento de la rama asociada con los cambios guardados.
  • git map te mostrará el historial de todas las ramas, y git map-branches te mostrará las relaciones ascendentes entre todas las ramas.
  • git new-branch --upstream_current <branch_name> crea una rama nueva sobre una existente. Usa git rebase-update para reubicar una rama dependiente después de realizar cambios en la rama base.

Seguir trabajando en una CL existente en una máquina diferente

Ejecuta git cl patch <issue_url> para seleccionar una CL existente además de la rama actual. Ten en cuenta que asociará la rama actual con la CL con parche. Usa git cl patch <issue_url> --reapply para descartar los cambios locales y volver a aplicar el problema.

Más entornos

Consulta el instructivo de las herramientas de depósito y explora los mensajes de ayuda para cada comando a fin de descubrir todas las funciones interesantes. Avísanos si tienes algún problema.