Übung – Quellcodeverwaltung mit Git

  • 10 Minuten

In dieser Übung wird das Cronus-Beispielunternehmen der US-Version von Business Central angewendet. Möglicherweise müssen Sie die Schritte anpassen, wenn Sie das Beispielunternehmen für Ihr Land oder Ihre Region verwenden.

Szenario

Sie sind ein Entwickler und arbeiten für CRONUS International Ltd. Sie möchten eine neue AL-Erweiterung erstellen, sie mit Git zur Versionskontrolle hinzufügen und den Code in Azure Repos schützen.

Aufgaben

  • Eine neue AL-Erweiterung erstellen

  • Den Quellcode einem lokalen Git-Repository hinzufügen

  • Azure Repos als Remote-Git-Repository hinzufügen

  • Das lokale Git-Repository in das Remote-Repository übertragen

Schritte

  1. Starten Sie Visual Studio Code.

  2. Wählen Sie Ansicht>Erweiterungen (STRG+UMSCHALT+X) aus.

  3. Geben Sie AL Language in das Suchfeld Nach Extensions in Marketplace suchen ein.

  4. Wählen Sie dann die grüne Schaltfläche Installieren aus.

  5. Erstellen Sie ein neues AL-Erweiterungsprojekt. Wählen Sie Anzeigen>Befehlspalette... (STRG+UMSCHALT+P) aus.

  6. Geben Sie AL: Go! in das Suchfeld ein, und wählen Sie den Befehl aus der Liste aus.

  7. Akzeptieren Sie den vorgeschlagenen Pfad (oder geben Sie einen anderen Pfad ein).

  8. Wählen Sie die aktuelle Zielplattform aus.

  9. Wählen Sie als Entwicklungsendpunkt Microsoft Cloud Sandbox aus.

  10. Laden Sie die Anwendungssymbole herunter, indem Sie Ansicht>Befehlspalette... (STRG+UMSCHALT+P) auswählen.

  11. Geben Sie AL: Symbole herunterladen in das Suchfeld ein, und wählen Sie den Befehl aus der Liste aus.

  12. Geben Sie auf Anfrage Ihre organisatorischen Anmeldeinformationen an (Microsoft 365-Konto oder Microsoft Entra ID-Konto).

  13. Öffnen Sie die Datei App.json, und ändern Sie die Einstellung Name in Hello Business Central und die Einstellung Herausgeber in Cronus International Ltd..

  14. Installieren Sie Git (falls nicht vorhanden) über die Seite zum Git installieren.

  15. Wählen Sie in Visual Studio Code Ansicht>SCM (STRG+UMSCHALT+G) aus, um die Quellcodeverwaltungsansicht zu öffnen.

  16. Klicken Sie auf die Schaltfläche Repository initialisieren, um ein lokales Repository für die aktuelle AL-Erweiterung zu initialisieren.

  17. Ihre Dateien werden jetzt mit einem Status U am Ende angezeigt, das angibt, dass sie nicht nachverfolgt werden. Klicken Sie mit der rechten Maustaste auf die erste .app-Datei, und wählen Sie „Zu .gitignore hinzufügen“ aus. Sie können diesen Schritt nur innerhalb der Ansicht Quellcodeverwaltung und nicht in derExplorer-Ansicht ausführen

  18. Wiederholen Sie diesen Vorgang für jede .app-Datei und für die launch.json-Datei.

  19. Wählen Sie alle Dateien aus, klicken Sie mit der rechten Maustaste, und wählen Sie Phasenänderungen aus, oder klicken Sie auf das +-Symbol neben Änderungen. Diese Aktion fügt die Dateien dem Staging-Bereich hinzu.

  20. Fügen Sie die Nachricht Erstes Commit zum Nachrichtenfeld „Commit“ hinzu, und klicken Sie dann auf die Schaltfläche „Commit“ (Häkchen), oder drücken Sie STRG + EINGABETASTE

  21. Öffnen Sie Ihren bevorzugten Webbrowser, und öffnen Sie Ihre Azure DevOps-Organisation.

  22. Wählen Sie das Projekt Hello Business Central aus, wenn Sie es in der Videodemonstration erstellt haben, oder erstellen Sie ein neues Projekt, wenn dieses Projekt nicht verfügbar ist.

  23. Klicken Sie im linken Menü auf Repos. Sie werden sehen, dass das Repository leer ist und Sie dem Repository Code hinzufügen können.

  24. Kopieren Sie den https-Link, den Sie im Abschnitt Auf dem Computer klonen finden.

  25. Öffnen Sie Visual Studio Code, drücken Sie F1, und geben Sie Git: Remote hinzufügen... im Suchfeld ein.

  26. Geben Sie folgenden Remotenamen ein: origin

  27. Fügen Sie die URL, die Sie aus Azure Repos kopiert haben, in das Feld Remote-URL ein.

  28. Je nach Konfiguration fordert Visual Studio Code Sie auf, sich mit dem Microsoft-Konto/Unternehmenskonto bei Azure DevOps anzumelden. Wenn dies nicht funktioniert und Visual Studio Code Sie weiterhin auffordert, sich mit einem Benutzernamen und einem Kennwort anzumelden, können Sie zu Azure DevOps zurückkehren und unter dem Eingabefeld, in das Sie die Repo-URL kopiert haben, auf die Schaltfläche Git-Anmeldeinformationen generieren klicken. Auf diese Weise können Sie einen Benutzernamen und ein Kennwort kopieren, die Sie anstelle Ihres Standardkontos für Git verwenden können.

  29. Wenn das Remoterepository erfolgreich in Visual Studio Code verknüpft wurde, können Sie auf das Symbol Veröffentlichen links unten in Ihrem Visual Studio Code-Fenster klicken. Dies ist die Schaltfläche mit einem Wolkensymbol und einem Pfeil nach oben. Sie finden sie neben der master-Branch-Schaltfläche.

Durch diese Schritte wird Ihr lokaler Code in Azure Repos veröffentlicht.

  1. Öffnen Sie Azure DevOps und aktualisieren Sie die Seite, sodass Ihr Code angezeigt wird.

  2. ÖffnenSie Visual Studio Code, öffnen Sie die Datei HelloWorld.al, und ändern Sie Hello World in der Nachrichtenfunktion in Hello Business Central. Speichern Sie Ihre Änderungen (STRG+S).

  3. Öffnen Sie die Quellcodeverwaltungsansicht. Die Datei HelloWorld.al sollte als geändert angezeigt werden. Wählen Sie die Datei aus, und fügen Sie sie dem Staging-Bereich hinzu.

  4. Fügen Sie eine Commit-Nachricht hinzu, und klicken Sie auf die Schaltfläche „Commit“.

  5. Übertragen Sie nun Ihre Änderungen in das Remoterepository. Sie können auf die drei Punkte ... klicken, um ein Menü zu öffnen, und dann Übertragen auswählen. Sie können auch auf das Synchronisierungssymbol unten im Fenster klicken (dieselbe Position, an der Sie auf das Veröffentlichungssymbol geklickt haben). Diese Aktion wird synchronisiert. Daher wird ein Fenster angezeigt, in dem erwähnt wird, dass diese Aktion einen Abruf und eine Übertragung ausführt. Sie können zustimmen, indem Sie auf Ja klicken.

  6. Öffnen Sie Azure DevOps, aktualisieren Sie die Seite, und wählen Sie die Datei HelloWorld.al aus. Ihre Änderungen sollten angezeigt werden.