Erste Schritte mit Blockly

Blockly ist Open Source und wird hauptsächlich von einem kleinen Team verwaltet. Wir freuen uns über Beiträge von Entwicklern außerhalb des Kernteams. Ohne unsere Community können wir nicht jede angeforderte Funktion entwickeln oder jeden gemeldeten Fehler beheben. Dieser Abschnitt enthält allgemeine Anleitungen, die besonders hilfreich sein können, wenn Sie noch keine Erfahrung mit der Open-Source-Entwicklung haben.

Informationen speziell zu Blockly, die Sie lesen sollten, bevor Sie einen Beitrag leisten, finden Sie in den Abschnitten Beiträge zum Core leisten und Beiträge zu Beispielen leisten.

Welches Repository?

Ein Repository enthält alle Dateien für ein einzelnes Projekt. Blockly hat zwei Repositories: blockly-core und blockly-samples.

Blockly Core ist das Repository für die Blockly-Bibliothek. Verwenden Sie dieses Repository, wenn Sie das grundlegende Blockly-Verhalten so ändern möchten, dass es für alle Nutzer der Bibliothek gilt.

Blockly-Beispiele ist das Repository für Beispiele, Plug-ins und Codelabs. Verwenden Sie dieses Repository, wenn Sie ein Plug-in erstellen oder ändern, ein Codelab schreiben oder ein Beispiel erstellen oder ändern möchten.

Schritt für Schritt

Das sind die allgemeinen Schritte, die Sie bei jeder Änderung ausführen müssen.

  1. Installieren Sie Git und Node. Folgen Sie dazu den Links im Abschnitt Tools.
  2. Repository verzweigen und klonen GitHub bietet eine hervorragende Anleitung zum Forken eines Repositorys. Wenn Sie es auf Blockly anwenden möchten, ersetzen Sie einfach jede Instanz von octocat/Spoon-Knife durch RaspberryPiFoundation/blockly oder RaspberryPiFoundation/blockly-samples, je nachdem, in welchem Repository Sie arbeiten möchten.
  3. Fork synchronisieren GitHub bietet auch eine Anleitung zum Synchronisieren eines Forks.
  4. Hauptzweig ansehen In Blockly Core ist dies der develop-Zweig. In blockly-samples ist das der master-Branch.
  5. Installieren Sie Abhängigkeiten und Build-Tools, indem Sie npm install im Stammverzeichnis ausführen.
  6. Erstellen Sie einen neuen Branch, indem Sie git checkout -b myBranchName in einem Terminal ausführen. Der Name sollte Ihnen helfen, sich daran zu erinnern, woran Sie gerade arbeiten.
  7. Nehmen Sie die gewünschten Änderungen vor.
  8. Validieren Sie Ihre Änderungen anhand der Anleitung für core oder samples.
  9. Speichern Sie die Änderungen mit git commit -am "fix: My commit message". Weitere Informationen zu Commit-Nachrichten
  10. Übertragen Sie Ihre Änderungen per Push mit git push origin myBranchName auf GitHub.
  11. Öffnen Sie eine Pull-Anfrage, wenn Ihr Code fertig ist. Ein Mitglied des Blockly-Teams prüft Ihre Änderungen und führt sie in Blockly zusammen, wenn sie genehmigt werden. Weitere Informationen finden Sie unter PR Review Process.