Tutorial: Arbeiten mit Source Control

Versionskontrolle, auch als Source Control bezeichnet, ist ein Verfahren zur Verfolgung und Verwaltung von Änderungen an Softwarecode oder Dateien innerhalb eines Projekts. Versionskontrollsysteme sind Softwaretools, mit denen Teams Änderungen an einem Projekt im Laufe der Zeit verwalten können.

Versionskontrollsoftware hilft, den Überblick über Änderungen zu behalten, und sorgt dafür, dass Teammitglieder immer mit der neuesten Version arbeiten. Sie sollte Ihnen helfen, die Entwicklung und Auslieferung zu beschleunigen, indem sie die Transparenz verbessert und die Zusammenarbeit der Teams unterstützt. Änderungen werden in einem Datenbanktyp gespeichert, der als Repository bezeichnet wird. Wenn ein Fehler gemacht wird, können Sie frühere Versionen des StudioX-Projekts vergleichen, um den Fehler zu beheben und gleichzeitig die Unterbrechung für alle Teammitglieder zu minimieren.

Hinweis: Dieses Tutorial gilt nur für StudioX v2020.10 und v2021.4. Neuere StudioX-Versionen finden Sie unter Verwalten von Projekten mit GIT im StudioX-Handbuch.

Es ist verschiedene Versionskontrollsoftware verfügbar, doch dieses Handbuch verwendet Bitbucket und GitHub Desktop als Beispiele.

Erstellen von Repositorys

Lassen Sie Ihren Administrator oder Teammanager Repositorys für Sie erstellen. Eine allgemeine Best Practice ist es, zwei Repositorys zu haben:

• Ein persönliches Repository zum Speichern Ihrer persönlichen StudioX-Projekte, auf das andere Benutzer wahrscheinlich nicht zugreifen müssen.
• Ein freigegebenes Team-Repository für StudioX-Projekte, bei dem alle Mitglieder Ihres Teams oder Ihrer Organisation voraussichtlich Zugriff auf die Projektdateien benötigen.

Tipps und Ressourcen

• Arbeiten Sie nur mit einer einzelnen Verzweigung (z. B. Master).
• Erstellen Sie keine zusätzlichen Verzweigungen oder Pull-Requests ohne triftigen Grund. Diese können den Prozess der Verwendung der Versionskontrolle erschweren.
• Führen Sie immer eine Pull-Anforderung aus, um alle Änderungen aus dem Repository zu synchronisieren, bevor Sie mit der Arbeit an einem Projekt beginnen.
• Führen Sie immer einen Commit und einen Push aus, wenn Sie mit der Arbeit an einem Projekt fertig sind, um sicherzustellen, dass Ihre Änderungen in das Repository hochgeladen werden.
• Ausführlichere GitHub-Anleitungen finden Sie im GitHub Desktop-Dokumentationsportal.
• Weitere Anleitungen zur Arbeit mit der Sourcetree-App finden Sie im Dokumentationsportal von Atlassian.

<details>

<summary>GitHub Desktop</summary>

Herunterladen und Installieren von GitHub Desktop

Um GitHub Desktop zu verwenden, müssen Sie es herunterladen, installieren und auf Ihrer Maschine konfigurieren. Verwenden Sie bitte das GitHub-Handbuch zum Herunterladen und Installieren der Software.

Einrichten von GitHub Desktop auf Ihrer Maschine

Wenn Sie noch kein Konto haben, erstellen Sie eines und melden Sie sich bei der GitHub Desktop-Anwendung an.

So verbinden Sie ein Repository mit Ihrem lokalen Projekt:

1. Öffnen Sie die GitHub Desktop-Anwendung.
2. Klicken Sie auf das Datei-Menü und wählen Sie Repository klonen aus.

3. Im sich öffnenden Fenster:

   • Klicken Sie auf die Registerkarte GitHub.com.
   • Geben Sie den Namen des Repositorys ein.
   • Geben Sie Ihren \Documents\UiPath-Ordnerpfad in das Feld Lokaler Pfad ein.

4. Klicken Sie auf Klonen, sobald alles eingerichtet ist.

   
   

   

   
   

Arbeiten mit Projekten

Alle Änderungen aus dem Repository synchronisieren

Bevor Sie ein neues Projekt erstellen oder Änderungen an einem bestehenden Projekt in StudioX vornehmen, stellen Sie sicher, dass alle Projekte in StudioX geschlossen sind (am sichersten ist es, alle StudioX-Instanzen zu schließen)

1. Öffnen Sie die GitHub Desktop-Anwendung.

2. Wählen Sie das Repository, das das Projekt enthält, mit dem Sie arbeiten.

   
   

   

   
   
3. Klicken Sie oben auf das Menü Repository und wählen Sie Ziehen (Pull) aus.

Ein neues Projekt erstellen

So erstellen Sie ein neues StudioX-Projekt, das Versionskontrolle verwendet:

1. Erstellen Sie eine neue Aufgabe in StudioX.

2. Navigieren Sie im Feld Speicherort zu dem Ordner, der das richtige Repository darstellt (persönliches oder freigegebenes Team).

   
   

   

   
   

Dadurch wird das Projekt in einem eigenen Ordner im Stammverzeichnis des Repositorys platziert.

Hinweis:

Wenn Sie vorhandene Projekte in die Versionskontrolle verschieben möchten, kann der Ordner

manuell in den Repository-Ordner verschoben werden.

Änderungen werden committet

Sie können Änderungen von Ihrer lokalen Maschine so oft wie nötig im Online-Repository speichern (committen).

1. Schließen Sie das Projekt in StudioX.
2. Öffnen Sie die GitHub Desktop-Anwendung.

3. Wählen Sie das Repository aus, das das StudioX-Projekt enthält, für das Sie Änderungen committen möchten.

   
   

   

   
   
4. Geben Sie eine kurze Zusammenfassung der Änderungen in das Feld Zusammenfassung ein.

5. Klicken Sie auf die Schaltfläche Commit.

   
   

   

   
   
6. Klicken Sie oben auf das Menü Repository und wählen Sie Ziehen (Pull) aus.

7. Klicken Sie auf die Schaltfläche Ursprung pushen, um Ihre Änderungen an das Repository zu senden.

   
   

   

   
   

<details>

<details>

<summary>Bitbucket</summary>

Herunterladen und Installieren der Sourcetree-Anwendung

Um Sourcetree zu verwenden, müssen Sie es herunterladen, installieren und auf Ihrer Maschine konfigurieren. Verwenden Sie bitte das Atlassian-Handbuch zum Herunterladen und Installieren der Software.

Arbeiten mit Projekten

Alle Änderungen aus dem Repository synchronisieren

Bevor Sie ein neues Projekt erstellen oder Änderungen an einem bestehenden Projekt in StudioX vornehmen, stellen Sie sicher, dass alle Projekte in StudioX geschlossen sind (am sichersten ist es, alle StudioX-Instanzen zu schließen)

1. Öffnen Sie die Sourcetree-Anwendung.
2. Klicken Sie oben auf Remote.

3. Wählen Sie das Repository aus, das das Projekt enthält, mit dem Sie arbeiten, indem Sie auf Klonen klicken.

   
   

   

   
   

Ein neues Projekt erstellen

So erstellen Sie ein neues StudioX-Projekt, das Versionskontrolle verwendet:

1. Erstellen Sie eine neue Aufgabe in StudioX.

2. Navigieren Sie im Feld Speicherort zu dem Ordner, der das richtige Repository darstellt (persönliches oder freigegebenes Team).

   
   

   

   
   

Dadurch wird das Projekt in einem eigenen Ordner im Stammverzeichnis des Repositorys platziert.

Hinweis:

Wenn vorhandene Projekte in die Versionskontrolle verschoben werden müssen, kann der Ordner

manuell in den Repository-Ordner verschoben werden.

Änderungen werden committet

Sie können Änderungen von Ihrer lokalen Maschine so oft wie nötig im Online-Repository speichern (committen).

1. Schließen Sie das Projekt in StudioX.
2. Öffnen Sie die Sourcetree-Anwendung.
3. Stellen Sie sicher, dass das Repository mit dem StudioX-Projekt ausgewählt ist.
4. Klicken Sie auf das Symbol + neben den Dateien, die Sie committen möchten, um sie der Liste hinzuzufügen.
   
   

   

   
   
5. Aktivieren Sie das Kontrollkästchen Änderungen sofort an Ursprung/Master pushen.

6. Geben Sie eine Nachricht ein und klicken Sie in der unteren rechten Ecke auf Commit.

   
   

   

   
   

<details>