The Chromium Chronicle #22: Know Thy (Depot) Tools

Folge 22:von Edward Lesmes in San Francisco, Kalifornien (Juni 2021)
Vorherige Folgen

Depot Tools ist eine auf Git aufbauende Sammlung von Tools, die den Workflow von Entwicklern vereinfachen, die zur Chromium-Codebasis und damit verbundenen Projekten beitragen. Sie enthält Tools, mit denen Sie unter anderem den Code abrufen, Änderungen zur Überprüfung hochladen und den Bezahlvorgang auf dem neuesten Stand halten können.

Code abrufen

Führen Sie fetch chromium in einem leeren Verzeichnis aus. Mit dem Befehl fetch kann auch der Code für andere Repositories wie v8 oder webrtc abgerufen werden. Eine vollständige Liste finden Sie unter fetch help.

Änderung zur Überprüfung hochladen

Jeder CL entspricht einem einzelnen Zweig in Git. Führen Sie daher zuerst git new-branch <branch_name> aus, um einen neuen Zweig zu erstellen. Nehmen Sie beliebig viele Änderungen an diesem Zweig vor und führen Sie git cl upload aus, wenn er zur Überprüfung bereit ist.

git cl issue teilt Ihnen mit, mit welchem CL Ihr Zweig verknüpft ist. Verwende git cl issue <issue>, um sie zu ändern.

Bezahlvorgang immer auf dem neuesten Stand halten

Führen Sie git rebase-update regelmäßig aus, um lokale Zweige mit ihrem Upstream zu synchronisieren, und gclient sync, um third_party-Repositories zu aktualisieren und vorkompilierte Hooks auszuführen.

Mehrere Änderungslisten verwalten

  • git cl status zeigt die mit lokalen Zweigen verknüpften CLs und ihren Status an (nicht gesendet, LGTT, geschlossen usw.).
  • git freeze und git thaw funktionieren wie git stash, behalten aber den Zweig im Auge, der den gespeicherten Änderungen zugeordnet ist.
  • git map zeigt den Verlauf aller Zweige an und git map-branches zeigt die Upstream-Beziehungen zwischen allen Zweigen an.
  • git new-branch --upstream_current <branch_name> erstellt einen neuen Zweig auf einem vorhandenen Zweig. Verwenden Sie git rebase-update, um einen abhängigen Zweig neu zu erstellen, nachdem Sie Änderungen am Basiszweig vorgenommen haben.

An einem vorhandenen Änderungsprotokoll auf einem anderen Computer weiterarbeiten

Führen Sie git cl patch <issue_url> aus, um einen vorhandenen CL auf dem aktuellen Zweig auszuwählen. Beachten Sie, dass der aktuelle Zweig mit dem gepatchten CL verknüpft wird. Verwenden Sie git cl patch <issue_url> --reapply, um lokale Änderungen zu verwerfen und das Problem noch einmal anzuwenden.

Und noch mehr

Sehen Sie sich die Anleitung zu Depot-Tools und die Hilfemeldungen zu jedem Befehl an, um mehr über die nützlichen Funktionen zu erfahren. Lassen Sie uns wissen, ob Sie Probleme haben.