Überblick
Der Git-Quelleditor (ci.android.com/edit) ist ein browserbasiertes Tool zum Bearbeiten von Dateien im Android Open Source Project (AOSP) und zum Hochladen von Änderungen in Gerrit. Es ist für kleinere Änderungen an einer kleinen Anzahl von Dateien gedacht und bietet einen schnelleren Arbeitsablauf als das Herunterladen des Android-Quellbaums . Sie sollten mit dem gesamten Prozess der Übermittlung von Änderungen an AOSP mithilfe von Git, Repo und Gerrit vertraut sein, bevor Sie den Git-Quelleditor verwenden.
Wenn Sie eine Datei mit dem Git-Quelleditor bearbeiten, erfolgt die gesamte Arbeit auf Ihrem lokalen Computer, bis Sie Änderungen hochladen, um eine Gerrit-Änderungsliste zu erstellen.
Anmeldung
- Laden Sie den Git-Quelleditor in einem Browser.
Klicken Sie auf Anmelden , um sich bei Ihrem Konto anzumelden.
Abbildung 1. Anmeldeschaltfläche
Bearbeiten Sie Dateien und Änderungen
Git Source Editor verfügt über die folgenden Hauptworkflows:
- Bearbeiten Sie eine oder mehrere Dateien Ihrer Wahl in dem von Ihnen gewählten Zweig.
- Bearbeiten Sie eine Änderung. Wenn Sie eine Änderung bearbeiten, hängt das Ergebnis davon ab, wer die Änderung erstellt hat:
- Wenn Sie die Änderung erstellt haben, werden Ihre Änderungen im Git-Quelleditor als neues Patchset in die Änderung eingefügt.
- Wenn jemand anderes die Änderung erstellt hat, erstellen Ihre Git-Quelleditor-Änderungen eine neue Änderung, deren Eigentümer Sie sind, basierend auf der von Ihnen geladenen Änderung.
Laden Sie, was Sie bearbeiten möchten
Starten Sie eine Bearbeitungssitzung, indem Sie entweder eine Datei oder eine Änderung laden.
Dateien laden
Geben Sie die URL der Datei, die Sie bearbeiten möchten, in das Feld Datei/Pfad ändern oben auf der Seite ein.
Beispieldateipfad: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md
Klicken Sie auf Datei laden oder ändern .
Abbildung 2. Laden einer Datei oder Änderung
Die Datei wird im Editorbereich geladen. Der Navigationsbereich links vom Editorbereich ist ein Dateibrowser, der das Repo mit Ihrer vorinstallierten Datei öffnet.
Abbildung 3. Eine in den Bearbeitungsbereich geladene Datei
Sie können den Navigationsbereich verwenden, um weitere Dateien innerhalb desselben Repositorys zu öffnen. Wenn Sie mehrere Dateien öffnen, wird jede Datei als Registerkarte in der Zeile über dem Bearbeitungsbereich angezeigt. Klicken Sie auf eine Registerkarte, um diese Datei im Bearbeitungsbereich zu öffnen.
Abbildung 4. Registerkarten für geladene Dateien
Laden Sie eine Änderung
Navigieren Sie zu der Änderung, die Sie bearbeiten möchten, indem Sie die URL einer Gerrit-Änderungsliste in das Datei-/Änderungspfadfeld oben auf der Seite eingeben (siehe Abbildung 2).
Beispiel-Änderungslink: https://android-review.googlesource.com/c/platform/build/soong/+/1284176
Die Dateien in der Änderung werden im Bearbeitungsbereich geöffnet (siehe Abbildung 3).
Wenn die Änderung mehrere Dateien umfasst, wird jede Datei als Registerkarte in der Zeile über dem Bearbeitungsbereich angezeigt (siehe Abbildung 4). Klicken Sie auf eine Registerkarte, um diese Datei im Bearbeitungsbereich zu öffnen.
Nehmen Sie Ihre Änderungen vor
Bearbeiten Sie Dateien mithilfe des Textbearbeitungsbereichs. Von Ihnen bearbeitete Dateien werden in der Liste „Ausstehende Änderungen“ unterhalb des Bearbeitungsbereichs angezeigt. Wenn Sie versehentlich die Registerkarte einer Datei mit Änderungen schließen, können Sie die Datei mit intakten Änderungen erneut öffnen, indem Sie in der Liste „Ausstehende Änderungen“ auf ihren Namen klicken.
Änderungen einreichen
Sie erstellen und veröffentlichen Ihre Änderung an Gerrit im Git Source Editor. Anschließend verfolgen Sie die Genehmigung der Änderung in Gerrit.
Erstellen und veröffentlichen Sie die Änderungen
Befolgen Sie dieses Verfahren, um die von Ihnen vorgenommenen Änderungen zu erstellen und zu veröffentlichen.
Klicken Sie auf die entsprechende Schaltfläche:
- Klicken Sie auf Änderung erstellen , wenn Sie eine neue Änderung erstellen.
- Klicken Sie auf Änderung aktualisieren, wenn Sie eine vorhandene Änderung aktualisieren.
Es öffnet sich ein Dialogfenster.
Abbildung 5. Dialogfeld „Änderung erstellen“.
Geben Sie eine Änderungsbeschreibung ein, die zur Änderungsbeschreibung in Gerrit wird. Diese Beschreibung ist erforderlich. Wenn Sie eine vorhandene Änderung bearbeiten, können Sie bei Bedarf auch deren Beschreibung bearbeiten.
Deaktivieren oder aktivieren Sie optional das Kontrollkästchen Beim Erstellen veröffentlichen .
Dieses Feld ist standardmäßig ausgewählt.
Wenn dieses Kontrollkästchen beim Erstellen der Änderung aktiviert ist, wird die Änderung sofort an Gerrit veröffentlicht. Wenn das Kontrollkästchen nicht aktiviert ist, wird die Änderung auf Gerrit hochgeladen, aber nicht veröffentlicht.
Klicken Sie auf Erstellen .
Die Änderung wird auf Gerrit hochgeladen. Wenn Sie das Kontrollkästchen Beim Erstellen veröffentlichen aktiviert haben, wird die Änderung auch in Gerrit veröffentlicht. Die Änderung wird in einer Benachrichtigung oben auf dem Bildschirm verlinkt.
Abbildung 6. Benachrichtigung über die erstellte Änderung
Verfolgen Sie die Änderungsgenehmigung in Gerrit
Verfolgen Sie den Status der Änderungsübermittlung direkt in Gerrit, wie Sie es bei jeder anderen Änderung tun würden.
Abbildung 7. Verfolgung des Änderungsübermittlungsstatus in Gerrit
Dateiunterschiede anzeigen
Aktivieren Sie das Kontrollkästchen „Diff“ unterhalb des Bearbeitungsbereichs, um die Unterschiede der Bearbeitungen anzuzeigen, die Sie an der Datei vorgenommen haben, die im Bearbeitungsbereich aktiv ist. Dies ist nützlich, wenn Sie eine Datei ändern und eine vorhandene Änderung bearbeiten.
Abbildung 8. Dateiunterschiede anzeigen
Dateien wiederherstellen
Sie können Änderungen an einer einzelnen Datei oder an allen Dateien in der Liste der ausstehenden Änderungen rückgängig machen. Beide Wiederherstellungsoptionen machen Änderungen nur im Git-Quelleditor rückgängig. Sie werden die Änderung in Gerrit NICHT aktualisieren.
Eine einzelne Datei wiederherstellen
Um eine einzelne Datei rückgängig zu machen, klicken Sie in der Liste „Ausstehende Änderungen“ auf das X neben dem Dateinamen.
Abbildung 9. Abschnitt „Ausstehende Änderungen“.
Alle Dateien zurücksetzen
Um alle Dateien auf einmal zurückzusetzen, klicken Sie unterhalb des Bearbeitungsbereichs auf Alle Dateien wiederherstellen .
Abbildung 10. Schaltfläche „Alle Dateien wiederherstellen“.
Ein Popup-Dialogfeld wird geöffnet. Klicken Sie auf „Alle zurücksetzen“ , um die Änderungen in allen ausstehenden Dateien rückgängig zu machen, oder klicken Sie auf „Abbrechen“ , um die Änderungen beizubehalten und mit der Bearbeitung fortzufahren.
Abbildung 11. Bestätigungsdialogfeld „Alle Dateien wiederherstellen“.
Bearbeiten Sie eine Seite direkt über die Android-Codesuche
Sie können eine Datei im Git-Quelleditor direkt über die Android-Codesuche öffnen. Dies ist hilfreich, wenn Sie die Datei vor dem Bearbeiten suchen müssen.
Befolgen Sie dieses Verfahren, um eine Datei direkt über die Android-Codesuche zu bearbeiten.
Navigieren Sie in der Android-Codesuche (cs.android.com) zu der Datei, die Sie bearbeiten möchten.
Klicken Sie auf Code bearbeiten .
Abbildung 12. Schaltfläche „Code bearbeiten“ für die Android-Codesuche
Der Git-Quelleditor wird mit der zur Bearbeitung vorausgewählten Datei geöffnet.
Wählen Sie in der Dropdown-Liste „ Git-Zweig auswählen“ den Git-Zweig aus, in dem Sie die Datei bearbeiten möchten, und klicken Sie dann auf „Zweig auswählen“ .
Abbildung 13. Auswählen eines Git-Zweigs zum Bearbeiten
Die Datei wird im Bearbeitungsbereich geöffnet.
Fahren Sie mit der Bearbeitung fort, wie im Abschnitt „Änderungen vornehmen“ beschrieben.
Sie können zusätzliche Dateien zum Bearbeiten öffnen, wie im Abschnitt „Dateien laden“ beschrieben
Konflikte lösen
So lösen Sie Konflikte:
Navigieren Sie im Quelleditor zur Änderung. Nachdem die Änderung geladen wurde, werden die in Konflikt stehenden Dateien im unteren Teil des Bildschirms aufgelistet. Abbildung 14 zeigt beispielsweise, dass in der Datei
Android.pbein Konflikt vorliegt.
Abbildung 14. Konflikt mit dem Quelleditor
Klicken Sie auf eine in Konflikt stehende Datei. Die Datei wird geladen und zeigt widersprüchliche Inhaltsblöcke nacheinander und innerhalb von Git-Markern (
<<<<<<<und>>>>>>>) an.
Abbildung 15. Konfliktmarkierungen im Quelleditor
Beheben Sie den Konflikt, indem Sie die Datei bearbeiten und die Konfliktmarkierungen um den Inhalt, den Sie behalten möchten, manuell entfernen. Entfernen Sie außerdem die Inhalts- und Konfliktmarkierungen für Inhalte, die Sie nicht behalten möchten.
Klicken Sie auf „Änderung erstellen“ , um eine neue Änderung zu erstellen. Das Dialogfeld „Änderung erstellen“ wird angezeigt.
Abbildung 16. Änderung erstellen
Geben Sie eine Änderungsbeschreibung ein und klicken Sie auf Erstellen .
Feedback abschicken
Benutzen Sie den Bug-Button 
in der oberen rechten Ecke, um Feedback zum Git Source Editor zu geben.