GitHub - es ist eine beliebte Plattform für das Hosting von Repositories und die Zusammenarbeit an Projekten mit dem Git-Versionskontrollsystem. Eines der wichtigsten Tools, die GitHub zur Verfügung stellt, ist die Möglichkeit zum Erstellen und Diskutieren pull request. Pull request ist eine Möglichkeit, Änderungen am Quellcode eines Projekts vorzuschlagen und anzufordern, dass sie in den Hauptzweig des Repositorys aufgenommen werden. Dies ist sehr praktisch, wenn Sie mit anderen Entwicklern zusammenarbeiten und zur Entwicklung eines Projekts beitragen möchten.
In dieser Schritt-für-Schritt-Anleitung werden wir uns ansehen, wie Sie eine Pull-Anfrage auf GitHub durchführen. Der erste Schritt besteht darin, das Repository zu forken, dh eine persönliche Kopie des Repositorys in Ihrem Konto zu erstellen. Als nächstes müssen Sie den Fork des Repositorys mit dem Befehl auf die lokale Maschine lehnen git clone. Nehmen Sie dann die erforderlichen Änderungen am Projektcode vor und kommentieren Sie sie mit Befehlen git add und git commit. Danach können Sie die Änderungen mit dem Befehl an Ihr GitHub-Konto senden git push.
Sobald alle Änderungen an Ihr GitHub-Konto gesendet wurden, können Sie eine pull request erstellen. Gehen Sie dazu auf die Seite Ihres Repositorys und klicken Sie auf die Schaltfläche "New pull request". Danach müssen Sie den Zweig auswählen, an dem Sie die Änderungen vornehmen möchten, und den Zweig Ihres Repository-Forks auswählen. Dann können Sie die Änderungen kommentieren und auf die Schaltfläche "Pull request erstellen" klicken. Danach wird eine pull request erstellt, die Sie mit anderen Entwicklern besprechen, gegebenenfalls Änderungen vornehmen und die Änderungen schließlich in den Haupt-Repository-Zweig aufnehmen können.
Vorbereiten des Repositorys für PR auf Github
Bevor Sie eine pull request (PR) auf Github erstellen, müssen Sie ein Repository vorbereiten, damit Ihre Änderungen ordnungsgemäß in den Hauptzweig des Projekts integriert werden. In diesem Abschnitt betrachten wir einige wichtige Schritte, die Sie ausführen müssen, bevor Sie eine pull request erstellen.
Schritt 1: Repository-Gabel
Der erste Schritt besteht darin, eine Gabel des ursprünglichen Repositorys zu erstellen. Dadurch können Sie Ihre Änderungen in einer separaten Kopie des Repositorys erstellen und speichern und eine pull request zur Überprüfung an den Besitzer des ursprünglichen Repositorys senden.
Schritt 2: Klonen des Repositorys
Nachdem Sie eine Gabel erstellt haben, müssen Sie sie auf Ihren lokalen Computer klonen. Um dies zu tun, können Sie den Befehl git clone an der Eingabeaufforderung oder ein praktisches grafisches Programm verwenden, um mit Git zu arbeiten.
Schritt 3: Erstellen eines neuen Zweiges
Sie müssen wahrscheinlich eine neue Verzweigung erstellen, bevor Sie Änderungen am Projektcode vornehmen. Dies ermöglicht es Ihnen, unabhängig vom Hauptzweig des Projekts mit Ihren Änderungen zu arbeiten und den Prozess der Überprüfung des Codes zu vereinfachen.
Schritt 4: Änderungen vornehmen
Jetzt, da Ihr Repository eingerichtet ist, können Sie mit Änderungen am Code beginnen. Sie können neue Dateien erstellen, vorhandene Dateien ändern oder nicht benötigte Dateien löschen. Es ist wichtig, die Standards und den Stil des Projektcodes zu befolgen, damit Ihre PR berücksichtigt wird.
Schritt 5: Die Änderungen kommentieren und löschen
Nachdem Sie alle notwendigen Änderungen am Code vorgenommen haben, kommentieren Sie sie und platzieren Sie einen Zweig mit den Änderungen in Ihrem Remote-Repository. Verwenden Sie dazu die Befehle git commit und git push. Dadurch können Sie Ihre Änderungen speichern und anderen Entwicklern den Zugriff auf Ihre Änderungen gewähren.
Schritt 6: Erstellen einer Pull-Anforderung
Jetzt sind Sie bereit, eine pull request mit Ihren Änderungen im Quellrepository zu erstellen. Gehen Sie zur Repository-Seite auf Github und klicken Sie auf die Schaltfläche "New pull request". Wählen Sie dann Ihren Zweig als Änderungszweig und den Zweig, an dem Sie Änderungen vornehmen möchten, als Basiszweig aus.
Nachdem Sie eine pull request erfolgreich erstellt haben, kann der Besitzer des Quellrepositors Ihre Änderungen überprüfen, Kommentare hinterlassen und akzeptieren, wenn sie die Anforderungen des Projekts erfüllen. Denken Sie daran, dass sauberer und gut gestalteter Code eine bessere Chance hat, akzeptiert zu werden.
Erstellen eines neuen Fork-Projekts
Bevor Sie eine pull request auf GitHub durchführen, müssen Sie eine neue Gabel (Kopie) des Projekts erstellen, an dem Sie Änderungen vornehmen möchten.
Um einen Fork eines Projekts zu erstellen, müssen Sie sich bei Ihrem GitHub-Konto anmelden und die Repository-Seite des Projekts finden, an dem Sie Änderungen vornehmen möchten.
Suchen Sie auf der Repository-Seite in der oberen rechten Ecke des Bildschirms nach der Schaltfläche "Fork" (Verzweigen) und klicken Sie darauf.
Nachdem Sie auf die Schaltfläche "Fork" geklickt haben, erstellt GitHub eine Kopie des Repositorys in Ihrem Konto.
Jetzt haben Sie Ihre eigene Projektgabel, in der Sie Änderungen vornehmen und neue Zweige erstellen können.
Es ist wichtig sich daran zu erinnern, dass Ihre Änderungen nur in Ihrer Projektgabel angezeigt werden, und dass sie in das ursprüngliche Projekt gelangen, müssen Sie eine pull request senden.
Eine Gabel auf einen lokalen Computer klonen
Bevor Sie mit Git und Github beginnen, müssen Sie das Repository (Fork) auf Ihrem lokalen Computer klonen. Dies ermöglicht es Ihnen, Änderungen am Code vorzunehmen und sie an das ursprüngliche Projekt anzupassen.
Um die Gabel zu klonen, müssen Sie Git auf Ihrem Computer installieren und die folgenden Schritte ausführen:
- Öffnen Sie Git Bash oder eine andere Eingabeaufforderung, die Git unterstützt.
- Kopieren Sie den Link zu Ihrer Gabel, der auf der Repository-Seite auf Github zu finden ist.
- Geben Sie an der Eingabeaufforderung git clone ein und fügen Sie den kopierten Link ein:
| Das Team | Die Beschreibung |
|---|---|
| git clone https://github.com/your-username/your-fork.git | Klont ein Repository (Fork) auf Ihren Computer. |
Nachdem Sie den Befehl ausgeführt haben, kopiert Git das Repository auf Ihren lokalen Computer und Sie sind bereit, Änderungen am Code vorzunehmen.
Sie haben jetzt eine Kopie der Gabel auf Ihrem lokalen Computer, die Sie ändern können. Nachdem Sie die Änderungen vorgenommen haben, können Sie eine pull request erstellen, um diese Änderungen an Ihrem ursprünglichen Projekt vorzunehmen.
Erstellen eines neuen Zweiges, um Änderungen vorzunehmen
Bevor Sie eine Pull-Anforderung auf GitHub durchführen, müssen Sie einen neuen Zweig erstellen, der die erforderliche Funktionalität enthält oder Fehler korrigiert. Dadurch werden die Änderungen vom Hauptprojektzweig getrennt und der Code-Review-Prozess wird vereinfacht.
Es gibt verschiedene Möglichkeiten, einen neuen Zweig auf GitHub zu erstellen:
| Art | Das Team |
|---|---|
| Über die GitHub-Schnittstelle | 1. Rufen Sie die Repository-Seite auf GitHub auf 2. Klicken Sie auf "Branch": main" (der Name des Zweiges kann sich unterscheiden) 3. Geben Sie einen Namen für den neuen Zweig ein und drücken Sie die Eingabetaste |
| Über die Befehlszeile | 1. Öffnen Sie ein Terminal oder eine Eingabeaufforderung 2. Wechseln Sie zum Projektverzeichnis 3. Geben Sie den Befehl "git branch" ein (ohne Anführungszeichen) 4. Drücken Sie die Eingabetaste |
| Über den Git-Client | 1. Öffnen Sie einen Git-Client (z. B. GitKraken, SourceTree) 2. Suchen Sie das Projekt in der Repository-Liste 3. Wählen Sie im Kontextmenü des Repositorys "Branch erstellen" 4. Geben Sie einen Namen für den neuen Zweig ein und bestätigen Sie |
Nachdem Sie einen neuen Zweig erstellt haben, können Sie ihm die erforderlichen Dateien hinzufügen und die erforderlichen Änderungen vornehmen. Nachdem Sie die Änderungen abgeschlossen haben, müssen Sie ein Commit durchführen und den Zweig auf das Remote-Repository übertragen. Sie können dann mit der Erstellung einer Pull-Anforderung beginnen, um Ihre Änderungen an den Hauptzweig des Projekts vorzuschlagen.
Notwendige Änderungen vornehmen und Commit durchführen
Bevor Sie eine pull request auf GitHub erstellen, müssen Sie die erforderlichen Änderungen am Repository vornehmen. Dies kann mit dem Befehl git commit erfolgen.
1. Wechseln Sie in das Projektverzeichnis, für das Sie eine pull request erstellen möchten.
2. Öffnen Sie die Datei oder die Dateien, die Sie bearbeiten möchten, mit einem Texteditor und nehmen Sie die erforderlichen Änderungen vor.
3. Öffnen Sie dann ein Terminal oder eine Eingabeaufforderung und führen Sie den Befehl git add aus, um die geänderten Dateien dem Index hinzuzufügen.
4. Führen Sie dann den Befehl git commit -m "Beschreibung Ihrer Änderungen" aus, um die Änderungen im lokalen Repository zu speichern.
5. Wenn Sie Änderungen an mehreren Dateien vornehmen möchten, können Sie für jede Datei den Befehl git add verwenden und dann den Befehl git commit nur einmal ausführen, um alle Änderungen zu speichern.
6. Nachdem Sie den Befehl git commit ausgeführt haben, können Sie den Commit-Verlauf mit dem Befehl git log überprüfen, um sicherzustellen, dass Ihre Änderungen erfolgreich gespeichert wurden.
Jetzt können Sie eine pull request auf GitHub erstellen und Ihre Änderungen vorschlagen, um sie mit dem Haupt-Repository zusammenzuführen.
Senden einer Pull-Anfrage an Github
Um eine Pull-Anfrage an Github zu senden, folgen Sie dieser einfachen Schritt-für-Schritt-Anleitung:
Schritt 1: Geben Sie das Repository ein
Rufen Sie die Seite des Repositorys auf, an dem Sie Änderungen vornehmen möchten, und klicken Sie auf die Schaltfläche "Fork" (Fork). Dadurch wird eine Kopie des Repositorys in Ihrem Konto erstellt.
Schritt 2: Klonen Sie das Repository auf Ihren Computer
Öffnen Sie Git Bash oder ein anderes Terminal und führen Sie den Befehl aus:
git-Klon https://github.com/ваш-аккаунт/название-репозитория.git
Ersetzen Sie "Ihr-Konto" durch Ihr Github-Konto und "Name-Repository" durch den Namen des Fork-Repositorys.
Schritt 3: Erstellen Sie einen neuen Zweig
Navigieren Sie mit dem Befehl zum gekippten Repository:
Erstellen Sie einen neuen Zweig mit dem Befehl:
git checkout -b Titel-Zweige
Schritt 4: Änderungen vornehmen
Öffnen Sie die Dateien, die Sie bearbeiten möchten, und nehmen Sie die gewünschten Änderungen vor. Sie können einen beliebigen Texteditor oder eine integrierte Entwicklungsumgebung verwenden.
Schritt 5: Übernehmen Sie die Änderungen
Überprüfen Sie die von Ihnen vorgenommenen Änderungen mit dem Befehl:
Fügen Sie alle geänderten Dateien mit dem Befehl zum Index hinzu:
Übernehmen Sie die Änderungen mit dem Befehl:
git commit -m "Ihr Kommentar"
Schritt 6: Senden Sie die Änderungen an Github
Senden Sie den von Ihnen erstellten Zweig mit dem Befehl an Github:
git push origin Titel-Zweige
Schritt 7: Erstellen Sie eine pull request
Rufen Sie die Seite des Fork-Repositorys auf Github auf. Sie sehen eine Nachricht, die Sie auffordert, eine pull request zu erstellen. Klicken Sie auf die Schaltfläche "Compare & pull request" (Pull request vergleichen und senden) und geben Sie das Haupt-Repository an, an das Sie die Änderungen senden möchten. Füllen Sie die Beschreibung pull request aus und klicken Sie auf den Button "Create pull request" (Pull request erstellen).
Glückwunsch! Jetzt haben Sie eine Pull-Anfrage an Github gesendet. Warten Sie auf Kommentare und Feedback vom Repository-Besitzer. Wenn Sie Änderungen vornehmen müssen, aktualisieren Sie einfach Ihren Zweig und senden Sie ihn erneut.
