Erstellen deines ersten Repositorys mit GitHub Desktop

Einführung

GitHub Desktopist eine kostenlose, Open Source Anwendung, die Ihnen hilft, mit Code zu arbeiten, der auf GitHub oder anderen Git-Hostingdiensten gehostet wird. Mit GitHub Desktop können Sie Git-Befehle, z. B. Änderungen committen und pushen, in einer grafischen Benutzeroberfläche ausführen, anstatt die Befehlszeile zu verwenden. Weitere Informationen finden Sie unter Informationen zu GitHub Desktop.

Am Ende dieses Leitfadens haben Sie GitHub Desktop verwendet, um ein Repository zu erstellen, Änderungen am Repository vorzunehmen und die Änderungen in GitHub zu veröffentlichen.

Nach der Installation von GitHub Desktop und der Anmeldung bei GitHub oder GitHub Enterprise können Sie ein Tutorial-Repository erstellen und klonen. Das Tutorial führt in die Grundlagen der Arbeit mit Git und GitHub ein, einschließlich der Installation eines Texteditors, des Erstellens eines Branches, des Erstellens eines Commits, des Pushens auf GitHub und des Öffnens eines Pull Requests. Das Tutorial ist verfügbar, wenn Sie auf GitHub Desktop noch keine Repositories haben.

Wir empfehlen, das Tutorial abzuschließen. Wenn Sie GitHub Desktop jedoch durch das Erstellen eines neuen Repositorys erkunden möchten, führt Sie diese Anleitung durch die Verwendung von GitHub Desktop, um an einem Git-Repository zu arbeiten.

Teil 1: Installation von GitHub Desktop und Authentifizierung Ihres Kontos

Sie können auf jedem unterstützten Betriebssystem installieren GitHub Desktop . Nachdem Sie die App installiert haben, müssen Sie sich bei GitHub oder GitHub Enterprise anmelden und Ihr Konto authentifizieren, bevor Sie ein Tutorial-Repository erstellen und klonen können.

Weitere Informationen zu Installation und Authentifizierung findest du unter GitHub Desktop einrichten.

Teil 2: Erstellen eines neuen Repositorys

Wenn Sie keine mit GitHub Desktop verknüpften Repositorys haben, wird Ihnen die Meldung „Los geht’s!“ angezeigt. angezeigt. Dort kannst du auswählen, ob du ein Tutorialrepository erstellen und klonen, ein vorhandenes Repository aus dem Internet klonen, ein neues Repository erstellen oder ein vorhandenes Repository von deiner Festplatte hinzufügen möchtest.

Screenshot der Ansicht „Los geht's!“ In GitHub Desktop anzeigen.

Erstellen und Klonen eines Tutorialrepositorys

Wir empfehlen, als Ihr erstes Projekt ein Tutorial-Repository zu erstellen und zu klonen, um den Umgang mit GitHub Desktop zu üben.

Klicke auf Tutorialrepository erstellen.
Folgen Sie den Anweisungen im Tutorial, um einen Texteditor zu installieren, einen Branch zu erstellen, eine Datei zu bearbeiten, einen Commit zu erstellen, auf GitHub zu veröffentlichen und einen Pull Request zu öffnen.

Ein neues Repository erstellen

Wenn du kein Tutorialrepository erstellen und klonen möchtest, kannst du ein neues Repository erstellen.

Klicke auf Neues Repository auf deiner Festplatte erstellen... .
Fülle die Felder im Fenster „Neues Repository erstellen“ aus, und wähle deine bevorzugten Optionen aus.
- "Name" definiert den Namen Ihres Repositories sowohl lokal als auch auf GitHub.
- „Description“ (Beschreibung) ist ein optionales Feld, das du verwenden kannst, um weitere Informationen zum Zweck deines Repositorys anzugeben.
- „Local path“ (Lokaler Pfad) legt den Speicherort deines Repositorys auf deinem Computer fest. Erstellt standardmäßig GitHub Desktop einen GitHub Ordner in Ihrem Ordner "Dokumente", um Ihre Repositorys zu speichern, Sie können jedoch einen beliebigen Speicherort auf Ihrem Computer auswählen. Dein neues Repository ist ein Ordner am ausgewählten Speicherort. Wenn du dein Repository beispielsweise Tutorial nennst, wird in dem für deinen lokalen Pfad ausgewählten Ordner ein Ordner namens Tutorial erstellt. GitHub Desktop merkt sich ihren gewählten Speicherort beim nächsten Erstellen oder Klonen eines neuen Repositorys.
- Mit Dieses Repository mit einer README-Datei initialisieren wird ein anfänglicher Commit mit einer README.md-Datei erstellt. READMEs helfen, den Zweck deines Projekts zu verstehen. Daher empfehlen wir, diese Option auszuwählen und die Datei mit nützlichen Informationen zu füllen. Wenn jemand Ihr Repository auf GitHub besucht, ist die README das Erste, das sie sehen, wenn sie sich über Ihr Projekt informieren. Weitere Informationen finden Sie unter Info zur Infodatei des Repositorys.
- Mithilfe des Dropdownmenüs Git ignorieren kannst du eine benutzerdefinierte Datei hinzufügen, um bestimmte Dateien in deinem lokalen Repository zu ignorieren, die nicht in der Versionskontrolle gespeichert werden sollen. Wenn du eine bestimmte Sprache oder ein bestimmtes Framework verwendest, kannst du aus der verfügbaren Liste eine entsprechende Option auswählen. Für den Anfang kannst du diese Auswahl überspringen. Weitere Informationen finden Sie unter Ignorieren von Dateien.
- Über das Dropdownmenü Lizenz kannst du einer LICENSE-Datei in deinem Repository eine Open-Source-Lizenz hinzufügen. Du musst dir keine Sorgen machen, sofort eine Lizenz hinzuzufügen. Weitere Informationen zu verfügbaren Open-Source-Lizenzen und dazu, wie du diese zu deinem Repository hinzufügst, findest du unter Ein Repository lizenzieren.
Klicke auf Repository erstellen.

Teil 3: Erkunden GitHub Desktop

Im Menü „Datei“ oben auf dem Bildschirm können Sie auf Einstellungen und Aktionen zugreifen, die Sie in GitHub Desktop ausführen können. Die meisten Aktionen besitzen auch Tastenkürzel, die dir bei der effizienteren Arbeit helfen. Eine vollständige Liste der Tastenkombinationen findest du unter GitHub Desktop-Tastenkürzel.

Die GitHub Desktop Repository-Leiste

Oben in der GitHub Desktop App wird eine Leiste angezeigt, die den aktuellen Status Ihres Repositorys anzeigt.

Screenshot der GitHub Desktop-App. Eine orangefarbene Leiste mit Details zum Repository „hello-world“ erstreckt sich über den oberen Teil des Fensters.

Aktuelles Repository zeigt den Namen des Repositorys an, an dem du arbeitest. Sie können auf "Aktuelles Repository" klicken, um zu einem anderen Repository zu wechseln.GitHub Desktop
Aktueller Zweig zeigt den Namen des Zweigs, an dem du arbeitest, an. Du kannst auf Aktueller Branch klicken, um alle Branches in deinem Repository anzuzeigen, zu einem anderen Branch zu wechseln oder einen neuen Branch zu erstellen. Sobald du Pull Requests in deinem Repository erstellt hast, kannst du diese ebenfalls durch Klicken auf Aktueller Branch anzeigen.
Repository veröffentlichen erscheint, weil Sie Ihr Repository noch nicht auf GitHub veröffentlicht haben, was Sie im nächsten Schritt tun werden. Dieser Abschnitt der Leiste ändert sich basierend auf dem Status deines aktuellen Branchs und Repositorys. Es sind verschiedene kontextabhängige Aktionen verfügbar, mit denen du Daten zwischen deinen lokalen Repositorys und Remoterepositorys austauschen kannst.

Änderungen und Verlauf

Auf der linken Seitenleiste werden die Ansichten Änderungen und Verlauf angezeigt.

Screenshot der GitHub Desktop-App. Eine orange umrandete Seitenleiste auf der linken Seite enthält die Registerkarten „Änderungen“ und „Verlauf“.

In der Ansicht Änderungen werden Änderungen angezeigt, die du an Dateien in deinem aktuellen Branch vorgenommen, aber nicht an dein lokales Repository committet hast. Unten wird ein Feld mit den Textfeldern „Zusammenfassung“ und „Beschreibung“ sowie der Schaltfläche In BRANCH übernehmen angezeigt. Hier committest du die neuen Änderungen. Die Schaltfläche Auf BRANCH übertragen ist dynamisch und zeigt an, auf welchen Branch du deine Änderungen überträgst.
Die Ansicht Verlauf zeigt die vorherigen Commits für den aktuellen Branch deines Repositorys an. Es sollte ein „Initial Commit“ angezeigt werden, der von GitHub Desktop erstellt wurde, als Sie Ihr Repository erstellt haben. Rechts neben dem Commit werden abhängig von den beim Erstellen deines Repositorys ausgewählten Optionen möglicherweise .gitattributes-, .gitignore-, LICENSE- oder Infodateien angezeigt. Du kannst auf jede Datei klicken, um ein Diff-Element für die jeweilige Datei anzuzeigen. Hierbei handelt es sich um die Änderungen, die in diesem Commit an der Datei vorgenommen wurden. Der Diff-Wert zeigt nur die Teile der Datei, die sich geändert haben, und nicht den gesamten Dateiinhalt.

Teil 4: Veröffentlichen Ihres Repositorys in GitHub

Wenn du ein neues Repository erstellst, ist es nur auf deinem Computer vorhanden, und du bist die einzige Person mit Zugriff darauf. Sie können Ihr Repository auf GitHub veröffentlichen, um es auf mehreren Computern synchronisiert zu halten und anderen Personen den Zugriff darauf zu ermöglichen. Um Ihr Repository zu veröffentlichen, pushen Sie Ihre lokalen Änderungen an GitHub.

Klicke in der Repositoryleiste auf Repository veröffentlichen.

Screenshot der Repository-Leiste. Eine Schaltfläche mit der Beschriftung „Repository veröffentlichen“ ist durch einen orangefarbenen Rahmen hervorgehoben.

Gib im Fenster „Repository veröffentlichen“ Details für dein neues Repository ein.
- GitHub Desktop füllt automatisch die Felder "Name" und "Beschreibung" mit den Informationen aus, die Sie beim Erstellen des Repositorys eingegeben haben.
- Mit der Option Diesen Code privat halten kannst du steuern, wer dein Projekt anzeigen kann. Wenn Sie diese Option nicht auswählen, können andere Benutzer auf GitHub Ihren Code einsehen. Wenn du diese Option aktivierst, ist dein Code nicht öffentlich verfügbar.
- Das Dropdown-Menü Organisation, falls vorhanden, ermöglicht es Ihnen, Ihr Repository auf GitHub in einer bestimmten Organisation zu veröffentlichen, der Sie angehören.
1. Klicke auf Repository veröffentlichen.
2. Sie können von innen GitHubaus auf das Repository GitHub Desktop zugreifen. Klicke im Dateimenü auf Repository und dann auf Auf GitHub anzeigen. Dadurch gelangst du in deinem Standardbrowser direkt zum Repository.

Teil 5: Vornehmen von Änderungen sowie Committen und Pushen von Änderungen

Nachdem du nun dein Repository erstellt und veröffentlicht hast, kannst du Änderungen an deinem Projekt vornehmen und mit der Durchführung deines ersten Commits an dein Repository beginnen.

Wenn Sie Ihren externen Editor in GitHub Desktopder Menüleiste "GitHub Desktop" starten möchten, wählen Sie " Repository" aus, und klicken Sie dann im EDITOR auf "Öffnen". Weitere Informationen finden Sie unter Konfigurieren eines Standard-Editors in GitHub Desktop.

Screenshot einer Menüleiste auf einem Mac. Unter dem geöffneten Dropdown-Menü „Repository“ bewegt sich ein Cursor über „In Visual Studio Code öffnen“, hervorgehoben in Blau.

Nimm einige Änderungen an der zuvor erstellten README.md-Datei vor. Du kannst Informationen hinzufügen, die dein Projekt beschreiben (z. B. Funktionsweise und warum es nützlich ist). Wenn du mit deinen Änderungen zufrieden bist, speichere sie in deinem Text-Editor.
Navigieren Sie in GitHub Desktop zur Ansicht Änderungen. In der Dateiliste solltest du deine README.md sehen. Das Kontrollkästchen links neben der README.md-Datei gibt an, dass deine Änderungen an der Datei Teil des Commits sind, den du durchführst. Künftig möchtest du möglicherweise an mehreren Dateien Änderungen vornehmen, gleichzeitig aber nur die Änderungen committen, die du an einigen der Dateien vorgenommen hast. Wenn du auf das Kontrollkästchen neben einer Datei klickst, wird diese Datei beim Commit nicht berücksichtigt.

Screenshot der Registerkarte „Änderungen“ in der Randleiste. Links neben der Datei „README.md“ ist ein ausgewähltes Kontrollkästchen mit einer orangefarbenen Umrandung hervorgehoben.

Gib unten in der Liste Änderungen eine Commitnachricht ein. Gib rechts neben deinem Profilbild eine kurze Beschreibung zum Commit ein. Da wir die README.md-Datei ändern, wäre „Informationen zum Projektzweck hinzufügen“ eine gute Commit-Nachricht. Unterhalb der Zusammenfassung wird das Textfeld „Beschreibung“ angezeigt, in dem du eine längere Beschreibung der im Commit vorgenommenen Änderungen eingeben kannst. Dies ist hilfreich, wenn du dir den Projektverlauf ansehen und nachvollziehen möchtest, weshalb die Änderungen vorgenommen wurden. Da du eine grundlegende Aktualisierung der README.md-Datei vornimmst, kannst du die Beschreibung überspringen.

Screenshot der Registerkarte „Änderungen“ in der Randleiste. Rechts neben einem Profilbild ist ein Textfeld, das eine Commitnachricht enthält, orange umrandet.

Klicke unterhalb der Commitnachricht auf In BRANCHNAMEN committen). Die Commitschaltfläche zeigt deinen aktuellen Branch an, sodass du sicher sein kannst, dass an den gewünschten Branch committet wird.
Um Ihre Änderungen in das Remote-Repository auf GitHub zu übertragen, klicken Sie auf Ursprung pushen.

Screenshot der Menüleiste „Repository“. Eine Schaltfläche mit der Beschriftung „Herkunft pushen“ ist durch einen orangefarbenen Rahmen hervorgehoben.

Die Schaltfläche „Push origin“ ist dieselbe, auf die Sie geklickt haben, um Ihr Repository in GitHub zu veröffentlichen. Diese Schaltfläche ändert sich kontextabhängig, je nachdem, in welcher Phase du dich im Git-Workflow befindest. Es sollte jetzt Push origin mit einem 1 daneben anzeigen, was darauf hinweist, dass ein Commit noch nicht zu GitHub gepusht wurde.
Das „origin“ in Push origin bedeutet, dass Sie Änderungen an das Remote namens origin pushen, das in diesem Fall das Repository Ihres Projekts auf GitHub ist. Bis Sie neue Commits an GitHub pushen, gibt es Unterschiede zwischen dem Repository Ihres Projekts auf Ihrem Computer und dem Repository Ihres Projekts auf GitHub. Auf diese Weise können Sie lokal arbeiten und Ihre Änderungen erst dann an GitHub pushen, wenn Sie bereit sind.

Im Fenster rechts neben der Ansicht Änderungen werden Vorschläge für Aktionen angezeigt, die du als Nächstes ausführen kannst. Um das Repository auf GitHub in Ihrem Browser zu öffnen, klicken Sie auf Auf GitHub anzeigen.

Screenshot des Bildschirms „Keine lokalen Änderungen“. In einer Liste mit Vorschlägen ist eine Schaltfläche mit der Beschriftung „Auf GitHub anzeigen“ mit einer orangefarbenen Umrandung hervorgehoben.

Klicke in deinem Browser auf 2 Commits. Du siehst auf GitHub eine Liste der Commits in diesem Repository. Der erste Commit sollte der Commit sein, den Sie gerade in GitHub Desktop erstellt haben.

Screenshot der Repositoryseite auf GitHub. Oberhalb der Liste der Dateien und neben einem Uhrsymbol ist ein Link mit der Bezeichnung „2 Commits“ orange umrandet.

Zusammenfassung

Sie haben nun ein Repository erstellt, das Repository unter GitHub veröffentlicht, einen Commit erstellt und Ihre Änderungen an GitHub übertragen. Du kannst denselben Workflow befolgen, wenn du zu anderen Projekten beiträgst, die du selbst erstellst oder an denen du mitwirkst.