Erste Schritte mit Blockly

Blockly ist Open Source und wird hauptsächlich von einem kleinen Team gepflegt. Wir begrüßen Beiträge von Entwicklern außerhalb des Kernteams. Ohne unsere Community könnten wir nicht jede angeforderte Funktion entwickeln oder jeden gemeldeten Fehler beheben. Dieser Abschnitt enthält allgemeine Anleitungen, die Ihnen vor allem dann helfen 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 Beitrag zum Blockly-Core leisten und Beitrag zu Samples 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 eine Änderung am grundlegenden Blockly-Verhalten vornehmen möchten, die 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.

Detaillierte Anleitung

So gehen Sie vor, wenn Sie eine Änderung vornehmen möchten:

  1. Installieren Sie Git und Node. Folgen Sie dazu den Links im Abschnitt Tools.
  2. Verzweigen und klonen Sie das Repository. GitHub bietet eine hervorragende Anleitung zum Forken eines Repos. Wenn Sie es auf Blockly anwenden möchten, ersetzen Sie einfach alle Instanzen von octocat/Spoon-Knife durch google/blockly oder google/blockly-samples, je nachdem, in welchem Repository Sie arbeiten möchten.
  3. Synchronisieren Sie Ihre Fork. GitHub bietet auch eine Anleitung zum Synchronisieren einer Fork.
  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. Folgen Sie dazu 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 mit git push origin myBranchName auf GitHub.
  11. Öffnen Sie einen Pull-Request, 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 Überprüfungsprozess für PR-Anfragen.