Verwalten von Projekten mit GIT

Die GIT-Integration in Studio erfordert die Microsoft Visual C++ 2015 Redistributable Update 3 x86 Version. Mehr erfahren Sie auf der Seite Softwareanforderungen.

GIT-Authentifizierung

Die Authentifizierungsmethoden in Studio unterscheiden sich entsprechend den Methoden zum Klonen eines GIT-Repositorys, entweder HTTPS oder SSH. Überprüfen Sie diese Seite zu sehen, welche Sie verwenden sollten, wenn Sie mit GitHub arbeiten.

Hinweis:

• Die GIT-Anmeldeinformationen, die Sie in Studio angeben, werden in der Windows-Anmeldeinformationsverwaltung gespeichert.
• Die GIT-Integration in Studio unterstützt derzeit keine zweistufige Authentifizierung. Verwenden Sie als Übergangslösung die SSO-Authentifizierungsmethode mit einem persönlichen Token oder die grundlegende Authentifizierungsmethode für den Zugriff.

Im aktuellen Handbuch werden die Schritte für die Authentifizierung in einem GitHub-Repository beschrieben, aber die Git-Integration in Studio ist nicht nur auf diesen Dienst beschränkt.

Über HTTPS

Wenn Sie ein Remote-GIT-Repository klonen oder das aktuelle Projekt zum ersten Mal mithilfe von HTTPS in ein vorhandenes GIT-Repository kopieren, müssen Sie Ihre GIT-Anmeldeinformationen angeben. Diese Anmeldeinformationen müssen in die Felder Anmeldeinformationen verwenden eingegeben werden:

Sie können sich authentifizieren mit:

• Benutzername und Kennwort in ihren spezifischen Feldern;
• Benutzername im Feld Benutzer und GIT-Token im Feld Token;

Führen Sie die auf dieser Seite beschriebenen Schritte aus, um ein GIT-Token für Ihr GitHub-Repository zu generieren.

Über SSH

Wenn Sie ein Repository klonen oder das aktuelle Projekt zum ersten Mal mit SSH in ein vorhandenes GIT-Repository kopieren, haben Sie die Möglichkeit, einen privaten Schlüssel zu verwenden:

Fügen Sie den Pfad für den privaten Schlüssel und das Kennwort hinzu, und klicken Sie dann auf Öffnen, um Ihr Remote-GIT-Repository zu klonen. Sehen Sie sich die hier beschriebenen Schritte an, um einen SSH-Schlüssel für Ihr GitHub-Repository zu generieren.

Authentifizierung fehlgeschlagen

Über HTTPS

Wenn das Kennwort oder der Benutzername beim Klonen eines GIT-Repositorys mithilfe der HTTPS-Methode falsch eingegeben wurde, wird das Fenster Anmeldeinformationen eingeben mit der Meldung Authentifizierung fehlgeschlagen angezeigt:

Geben Sie die richtigen Anmeldeinformationen (Benutzer und Kennwort ein, und versuchen Sie es erneut. Sie können z. B. auch Git Bash verwenden, um einen Remote-Klonvorgang für Ihr Repository auszuführen und so zu überprüfen, ob der Benutzername und das Kennwort korrekt sind.

In der folgenden Abbildung haben wir versucht, ein Repository über HTTPS zu klonen, aber ein falsches Kennwort eingegeben. Das Git Bash-Fenster zeigt, dass die Anmeldeinformationen falsch waren.

Über SSH

Das folgende Fenster Anmeldeinformationen eingeben wird angezeigt, wenn die Authentifizierung über SSH fehlschlägt:

Geben Sie den korrekten Pfad des privaten Schlüssels und das Kennwort ein, und versuchen Sie es erneut. Sie können z. B. auch Git Bash verwenden, um einen Remote-Klonvorgang für Ihr Repository auszuführen und so zu überprüfen, ob das Token und/oder Kennwort korrekt sind.

In der folgenden Abbildung haben wir versucht, ein Repository über SSH zu klonen, aber wir hatten keine öffentlichen SSH-Schlüssel in unserem Konto eingerichtet.

Klonen eines Remote-GIT-Repositorys

1. Wählen Sie auf der Registerkarte Team die Option Repository klonen aus. Das Fenster Ein Remote-GIT-Repository klonen. wird angezeigt.
2. Wählen Sie entweder Mit HTTPS klonen oder SSH verwenden aus.
3. Geben Sie die Repository-URL ein, und wählen Sie ein leeres Auscheckverzeichnis.
4. Klicken Sie auf das Kontrollkästchen Anmeldeinformationen verwenden oder Schlüssel verwenden, um Ihren Git-Benutzernamen oder Pfad des privaten Schlüssels und das Kennwort hinzuzufügen.
5. Klicken Sie auf Öffnen. Studio öffnet das Projekt im Panel Designer.
6. Wählen Sie im Fenster Öffnen (Open) eine project.json-Datei zum Öffnen in Studio aus.

Nachdem Sie ein GIT-Repository in einem lokalen Arbeitsverzeichnis geklont haben, wird das Unterverzeichnis .git erstellt. Es enthält die erforderlichen GIT-Metadaten. Die Metadaten enthalten Unterverzeichnisse für Objekte, Referenzen und Vorlagendateien. Außerdem wird eine Datei HEAD erstellt, die auf das aktuell ausgecheckte Commit verweist.

Hinzufügen eines Projekts zu GIT

Die Funktion GIT-Initialisierung fügt das aktuelle Projekt einem lokalen GIT-Repository hinzu. Greifen Sie über die Registerkarte Team oder die Statusleiste auf den Befehl zu.

1. Erstellen oder öffnen Sie ein Projekt in Studio. Klicken Sie auf die Registerkarte Start > Team. Die Registerkarte Team wird angezeigt.

2. Klicken Sie auf die Schaltfläche GIT-Initialisierung, und wählen Sie einen Pfad aus, an dem das Repository initialisiert werden soll. Der Speicherort kann derselbe wie für den Projekt- oder den übergeordneten Ordner sein. Das Fenster Änderungen committen wird geöffnet.

   
   

   

   
   
3. Im Abschnitt Geänderte Dateien werden die Projektdateien angezeigt, die dem GIT-Repository hinzugefügt werden sollen. Deaktivieren Sie das Kontrollkästchen neben denjenigen, die Sie nicht hinzufügen möchten, oder verwenden Sie Alle auswählen, Keine auswählen.

4. Wählen Sie das Feld Dateien ohne Versionsangabe anzeigen aus, um der Liste Dateien ohne Versionsangabe hinzuzufügen.

   Schreiben Sie eine Commit-Nachricht. Klicken Sie auf die Schaltfläche Commit, um die Änderungen an das lokale Git-Repository zu übertragen.

Wenn ein Projekt zu GIT hinzugefügt wird, enthält das Kontextmenü im Bedienfeld Projekt GIT-spezifische Optionen. Weitere Informationen finden Sie unter Kontextmenüoptionen für GIT.

Übergeben und Verschieben nach GIT

1. Klicken Sie in demselben Fenster Änderungen committen auf die Schaltfläche Committen und pushen, um die Änderungen zu übergeben und in das Remote-Repository zu verschieben. Dieses Fenster Remotes verwalten wird angezeigt. Das Fenster ist auch über die Statusleiste verfügbar.

   
   

   

   
   
2. Fügen Sie im Abschnitt Name den Namen des Remote-Repositorys hinzu.
3. Fügen Sie im Abschnitt URL die Remote-URL hinzu.

Wenn Sie Änderungen an den hinzugefügten Repositorys vornehmen möchten, klicken Sie einfach auf einen Eintrag, ändern Sie den Namen und die URL, und klicken Sie auf die Schaltfläche Aktualisieren. Wenn Sie fertig sind, klicken Sie auf Hinzufügen und dann auf Speichern. Das folgende Meldungsfeld wird geöffnet.

• Klicken Sie auf die Schaltfläche Remote-Inhalt überschreiben (Overwrite remote content), um die lokalen Versionen der Dateien in das Remote-Repository zu verschieben und die Dateien dort zu überschreiben.
• Klicken Sie auf die Schaltfläche Ziehen (Basis ändern) (Pull (rebase)), um die Remote-Dateien zu ziehen und die Basis der aktuellen Verzweigung zu ändern.
• Klicken Sie auf die Schaltfläche Abbrechen (Cancel), um die gesamte Operation abzubrechen.

Die Anzahl der nicht gepushten Änderungen sowie der neu hinzugefügten Dateien wird in der Statusleiste angezeigt. Klicken Sie auf das Symbol , um das Fenster Änderungen committen zu öffnen, oder das Symbol , um die Änderungen zu pushen.

Hinweis: Wenn Sie eine Datei von einem Projekt, das zu Source Control hinzugefügt wurde, in einem externen Editor bearbeiten, wird die Änderung im Panel Projekt und in der Statusleiste erst angezeigt, nachdem Sie im Projektfenster auf Aktualisieren geklickt haben.

Andern der letzten Übergabe

Das mit GIT integrierte Studio bietet außerdem eine Option zum Ändern der Übergabe (Amend Commit), mit der die zuletzt durchgeführte Übergabe vor dem Verschieben geändert werden kann.

1. Klicken Sie im Panel Projekt mit der rechten Maustaste auf eine geänderte Datei, und wählen Sie Commit aus. Das Fenster Änderungen committen wird angezeigt.

   
   

   

   
   
2. Wählen Sie das Feld Commit abändern aus. Die letzte Commit-Nachricht wird zusammen mit den Dateien angezeigt, für die ein Commit ausgeführt wurde. Um Änderungen zwischen der aktuellen Datei und dem letzten Commit anzuzeigen, verwenden Sie die Option Änderungen anzeigen.
3. Ändern Sie die Commit-Nachricht, und wählen Sie die Dateien aus, die Sie einschließen möchten. Klicken Sie auf die Schaltfläche Committen und pushen oder auf die Schaltfläche Commit.

Anstehende Änderungen rückgängig machen

Studio bietet die Option, Änderungen rückgängig zu machen, die an Dateien mit Versionsangabe durchgeführt wurden, bevor Sie die Dateien committen und in das Remote-Repository pushen.

Nachdem Änderungen an einer Datei im lokalen Repository durchgeführt wurden, klicken Sie auf Rückgängig machen (Undo) im GIT-Kontextmenü, um das Fenster Anstehende Änderungen rückgängig machen (Undo Pending Changes) zu öffnen.

Markieren Sie das Kontrollfeld neben den Dateien und klicken Sie auf Rückgängig machen (Undo). Die Dateien werden wieder in den Zustand versetzt, in dem sie vor Durchführung der Änderungen waren.

Hinweis: Der Vorgang Rückgängig deckt keine Dateien ohne Version ab. Wenn Sie neue Dateien erstellen und dann Rückgängig auswählen, werden die Dateien nicht aus dem Projekt entfernt. Nach dem Hinzufügen zur Projektstruktur bleiben neue Dateien dort, es sei denn, sie werden manuell gelöscht.

Kopieren eines Projekts nach GIT

Mit der Schaltfläche In GIT kopieren in der Studio Backstage-Ansicht und Statusleiste können Sie das aktuelle Projekt in ein vorhandenes GIT-Repository kopieren.

Dazu öffnen oder erstellen Sie ein Projekt in Studio. Aktivieren Sie auf der Registerkarte Team (Team) die Option Nach GIT kopieren (Copy to GIT) und wählen Sie einen vorhandenen GIT-Repository-Ordner auf Ihrem Computer aus. Das Projekt wird zum lokalen GIT-Repository hinzugefügt und das Meldungsfenster Nach GIT kopieren (Copy to GIT) wird geöffnet.

• Wählen Sie Ja (Yes), um das Projekt an dem neuen Speicherort zu öffnen. Das Fenster Änderungen übergeben (Commit changes) wird geöffnet. Schreiben Sie eine Übergabenachricht (Commit message) und klicken Sie auf Übergeben und Verschieben (Commit and Push) oder nur auf Übergeben (Commit).
• Mit Nein (No) wird wieder die Studio-Bedienoberfläche angezeigt.

Erstellen und Verwalten von Verzweigungen

1. Klicken Sie im Panel Projekt mit der rechten Maustaste auf den Projektknoten oder die enthaltene Datei oder auf das -Symbol in der Statusleiste, und wählen Sie Verzweigungen verwaltenaus. Das Fenster Verzweigungen verwalten wird angezeigt.

   
   

   

   
   
2. Klicken Sie auf die Schaltfläche , um eine Verzweigung hinzuzufügen. Tragen Sie im Abschnitt Name einen Namen für die Verzweigung ein. Klicken Sie auf Hinzufügen und dann auf Speichern. Die Verzweigung wird der Liste hinzugefügt.

Klicken Sie mit der rechten Maustaste auf eine beliebige Verzweigung, um die Optionen für GIT-Verzweigungen anzuzeigen:

• Die Option Verzweigung auschecken (Checkout branch) schaltet auf die ausgewählte Verzweigung um.
• Die Option Basis ändern (Rebase) ändert die Basis der aktuellen Verzweigung auf die ausgewählte Verzweigung.
• Die Option Zusammenführen (Merge) führt die ausgewählte Verzweigung mit der aktuellen Verzweigung zusammen.

Um eine Verzweigung in den Master-Abschnitt eines GIT-Remote-Repositorys zu überführen, müssen Sie die Master-Verzweigung in Studio auschecken und die geänderte Verzweigung dann in den Master-Abschnitt überführen.

Klicken Sie zum Wechseln zwischen den Verzweigungen in der Statusleiste auf das Symbol , um die Liste mit allen kürzlich ausgecheckten Verzweigungen zu öffnen. Klicken Sie auf ein Element, um die Verzweigung zu wechseln.

Konflikte lösen

Die GIT-Integration mit Studio bietet eine Funktion zum Lösen von Konflikten, die beim Ausführen des Befehls Umbasieren oder Push ausführen im Fenster Änderungen committen auftreten können.

Immer wenn Studio einen Konflikt zwischen der lokalen Datei und der im Remote-Repository angetroffenen erkennt, wird das Fenster zur Konfliktlösung geöffnet.

Das Fenster ähnelt dem Fenster Datei-Diff (File Diff). Es zeigt die Unterschiede zwischen der Remote-Version der Datei und der lokalen (Local) Version auf.

In der folgenden Tabelle werden die im Fenster Konflikte lösen verfügbaren Optionen beschrieben.

Option	Beschreibung
Linke auswählen (Choose Left)	Wählen Sie die linke Datei aus. Sie stellt die Datei im Remote-Repository dar, die verschoben werden soll.
Rechte auswählen (Choose Right)	Wählen Sie die rechte Datei aus. Sie stellt die Datei im lokalen Repository dar, die verschoben werden soll.
Speichern	Nach dem Auswählen der linken oder rechten Datei klicken Sie auf Speichern (Save).
Abbrechen	Brechen Sie die Operation ab und verlassen Sie das Fenster Konflikte lösen (Solve conflicts).
Vorherige (previous)	Navigiert zur vorherigen Änderung in den verglichenen Dateien.
Weiter	Navigiert zur nächsten Änderung in den verglichenen Dateien
Alle reduzieren (Collapse All)	Reduziert alle Knoten in den .xaml-Dateien.
Alle erweitern (Expand All)	Erweitert alle Knoten in den .xaml-Dateien.

Trennen von GIT

In den beiden folgenden Fällen steht die Option Trennen in der Studio Backstage-Ansicht auf der Registerkarte > Team für Dateien mit Versionsangabe zur Verfügung:

1. Ein Prozess wird als lokales GIT-Repository initialisiert. Erstellen Sie einen neuen Prozess, fügen Sie ihn mit GIT init (GIT Init) zu einem lokalen GIT-Repository hinzu und entfernen Sie mit Trennen (Disconnect) das Unterversions-Tag.
2. Das Unterversions-Tag kann durch Klicken auf Trennen (Disconnect) bei einem GIT-Repository entfernt werden, das über- und untergeordnete Projekte enthält.
3. Beim Trennen eines untergeordneten Projekts wird das gesamte GIT-Repository, das die geöffneten Projekte enthält, von der Quellenkontrolle getrennt. In Studio wird ein Meldungsfenster geöffnet, in dem Sie aufgefordert werden, zu bestätigen, bevor die Trennung ausgeführt wird.

Ändern der Signatur

Das Ändern der GIT-Commitsignatur kann über die Registerkarte Team > Signatur ändern durchgeführt werden. Geben Sie Ihren Namen und Ihre E-Mail-Adresse ein, und klicken Sie auf OK.

Verwenden von GIT mit einem Proxyserver

Die GIT-Integration in Studio unterstützt den Zugriff auf Remote-Repositorys, wenn der Internetzugang über einen Proxyserver erfolgt. Dies kann auf zwei Arten erfolgen: entweder konfiguriert auf Computerebene im Fenster Proxyeinstellungen oder durch Änderungen an git-Befehlen.

Proxydetails, die im Fenster Proxyeinstellungen konfiguriert sind, werden berücksichtigt, ohne dass sie in die .gitconfig-Datei eingegeben werden müssen.

Um Proxydetails mit git-Befehlen zu konfigurieren, fügen Sie diese im folgenden Formular zu GIT-Konfigurationsdateien hinzu:

[http "https://domain.com"] proxy = http://proxyUsername:[e-mail]:port

GIT-Konfigurationsdateien finden Sie an folgenden Speicherorten:

• config-Datei: %ProgramData%\Git
• .gitconfig-Datei: %UserProfile%
• lokale config-Datei aus Projektebene, z. B. %UserProfile%\Desktop estproject\.git.