Quellcodeverwaltungs-Workflow

Die Arbeit mit Android-Code erfordert die Verwendung von Git (ein Open-Source-Versionskontrollsystem) und Repo (ein von Google entwickeltes Repository-Verwaltungstool, das auf Git läuft). Eine Erläuterung der Beziehung zwischen Repo und Git sowie Links zu unterstützender Dokumentation für jedes Tool finden Sie unter Source Control Tools .

Fließen

Die Android-Entwicklung umfasst den folgenden grundlegenden Workflow:

  1. Starten Sie einen neuen Themenzweig mit repo start .
  2. Bearbeiten Sie die Dateien.
  3. Phasenänderungen mit git add .
  4. Commit Änderungen mit git commit .
  5. Laden Sie Änderungen mit dem repo upload auf den Überprüfungsserver repo upload .

Aufgaben

Die Arbeit mit Git und Repo in den Android-Code-Repositorys umfasst das Ausführen der folgenden allgemeinen Aufgaben.

Befehl Beschreibung
repo init Initialisiert einen neuen Client.
repo sync Synchronisiert den Client mit den Repositorys.
repo start Startet eine neue Filiale.
repo status Zeigt den Status des aktuellen Zweigs an.
repo upload Lädt Änderungen auf den Überprüfungsserver hoch.
git add Stellt die Dateien bereit.
git commit Überträgt die bereitgestellten Dateien.
git branch Zeigt die aktuellen Zweige an.
git branch [branch] Erstellt einen neuen Themenzweig.
git checkout [branch] Schaltet HEAD in den angegebenen Zweig um.
git merge [branch] Fügt [branch] in den aktuellen Branch ein.
git diff Zeigt Diff der nicht bereitgestellten Änderungen an.
git diff --cached Zeigt Diff der inszenierten Änderungen an.
git log Zeigt die Historie des aktuellen Zweigs an.
git log m/[codeline].. Zeigt die Commits an, die nicht gepusht werden.

Informationen zur Verwendung von Repo zum Herunterladen von Quellen finden Sie unter Herunterladen der Quelle und in der Repo-Befehlsreferenz .

Clients synchronisieren

So synchronisieren Sie die Dateien für alle verfügbaren Projekte:

repo sync

So synchronisieren Sie die Dateien für ausgewählte Projekte:

repo sync PROJECT0 PROJECT1 ... PROJECTN

Themenzweige erstellen

Starten Sie einen Themenzweig in Ihrer lokalen Arbeitsumgebung, wenn Sie mit einer Änderung beginnen, z. B. wenn Sie mit der Arbeit an einem Fehler oder einer neuen Funktion beginnen. Ein Themenzweig ist keine Kopie der Originaldateien; es ist ein Zeiger auf einen bestimmten Commit, was das Erstellen lokaler Branches und das Wechseln zwischen ihnen zu einem einfachen Vorgang macht. Durch die Verwendung von Verzweigungen können Sie einen Aspekt Ihrer Arbeit von den anderen isolieren. Einen interessanten Artikel zur Verwendung von Themenzweigen finden Sie unter Trennen von Themenzweigen .

Um einen Themenzweig mit Repo zu starten, navigieren Sie zum Projekt und führen Sie Folgendes aus:

repo start BRANCH_NAME .

Der nachgestellte Punkt ( . ) repräsentiert das Projekt im aktuellen Arbeitsverzeichnis.

So überprüfen Sie, ob der neue Branch erstellt wurde:

repo status .

Verwenden von Themenzweigen

So weisen Sie die Verzweigung einem bestimmten Projekt zu:

repo start BRANCH_NAME PROJECT_NAME

Eine Liste aller Projekte finden Sie unter android.googlesource.com . Wenn Sie bereits zum Projektverzeichnis navigiert sind, verwenden Sie einfach einen Punkt, um das aktuelle Projekt darzustellen.

Um zu einer anderen Filiale in Ihrer lokalen Arbeitsumgebung zu wechseln:

git checkout BRANCH_NAME

So zeigen Sie eine Liste vorhandener Filialen an:

git branch

oder

repo branches

Beide Befehle geben die Liste der vorhandenen Verzweigungen mit dem Namen der aktuellen Verzweigung mit einem vorangestellten Stern (*) zurück.

Staging-Dateien

Standardmäßig bemerkt Git die Änderungen, die Sie in einem Projekt vornehmen, aber verfolgt sie nicht. Um Git zu sagen Ihre Änderungen zu erhalten, müssen Sie markieren oder diese Änderungen für die Aufnahme in eine Festschreibung der Bühne.

Um Änderungen zu inszenieren:

git add

Dieser Befehl akzeptiert Argumente für Dateien oder Verzeichnisse innerhalb des Projektverzeichnisses. Trotz des Namens git add nicht nur Dateien zum Git-Repository hinzu; es kann auch verwendet werden, um Dateiänderungen und -löschungen bereitzustellen.

Kundenstatus anzeigen

So listen Sie den Status von Dateien auf:

repo status

So zeigen Sie nicht festgeschriebene Änderungen an (lokale Änderungen, die nicht zum Festschreiben markiert sind):

repo diff

Um festgeschriebene Änderungen anzuzeigen (lokalisierte Bearbeitungen, die zum Festschreiben markiert sind ), stellen Sie sicher, dass Sie sich im Projektverzeichnis befinden, und führen Sie dann git diff mit dem cached Argument aus:

cd ~/WORKING_DIRECTORY/PROJECT
git diff --cached

Änderungen vornehmen

Ein Commit ist die Grundeinheit der Revisionskontrolle in Git und besteht aus einem Snapshot der Verzeichnisstruktur und des Dateiinhalts für das gesamte Projekt. Verwenden Sie diesen Befehl, um einen Commit in Git zu erstellen:

git commit

Wenn Sie zu einer Commit-Nachricht aufgefordert werden, geben Sie eine kurze (aber hilfreiche) Nachricht für an AOSP übermittelte Änderungen ein. Wenn Sie keine Commit-Nachricht hinzufügen, schlägt der Commit fehl.

Hochladen von Änderungen in Gerrit

Aktualisieren Sie auf die neueste Version und laden Sie dann die Änderung hoch:

repo sync
repo upload

Diese Befehle geben eine Liste der von Ihnen übernommenen Änderungen zurück und fordern Sie auf, die Branches auszuwählen, die auf den Überprüfungsserver hochgeladen werden sollen. Wenn nur eine Verzweigung vorhanden ist, sehen Sie eine einfache Eingabeaufforderung für y/n .

Synchronisierungskonflikte lösen

Wenn der Befehl repo sync zurückgibt:

  1. Zeigen Sie die nicht zusammengeführten Dateien an (Statuscode = U).
  2. Bearbeiten Sie die Konfliktregionen nach Bedarf.
  3. Wechseln Sie in das entsprechende Projektverzeichnis. Fügen Sie die betroffenen Dateien hinzu und übergeben Sie sie fest, und rebasieren Sie dann die Änderungen:
    git add .
    git commit
    git rebase --continue
    
  4. Nachdem die Rebase abgeschlossen ist, starten Sie die gesamte Synchronisierung erneut:
    repo sync PROJECT0 PROJECT1 ... PROJECTN
    

Kunden aufräumen

Nachdem Sie die Änderungen an Gerrit zusammengeführt haben, aktualisieren Sie Ihr lokales Arbeitsverzeichnis und verwenden Sie dann repo prune , um veraltete repo prune sicher zu entfernen:

repo sync
repo prune

Kunden löschen

Da alle Statusinformationen in Ihrem Client gespeichert sind, müssen Sie nur das Verzeichnis aus Ihrem Dateisystem löschen:

rm -rf WORKING_DIRECTORY

Wenn Sie einen Kunden löschen, werden alle Änderungen dauerhaft gelöscht, die Sie nicht zur Überprüfung hochgeladen haben.