Beiträge für Blockly

Blockly ist eine Open-Source-Lösung 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 erstellen oder jeden gemeldeten Fehler beheben. Dieser Abschnitt enthält allgemeine Leitfäden, die für Sie hilfreich sein können, insbesondere wenn Sie mit der Open-Source-Entwicklung noch nicht vertraut sind.

Informationen zu Blockly, die Sie lesen sollten, bevor Sie einen Beitrag leisten, finden Sie in den Abschnitten Beitrag zu Kern und Beitrag zu Beispielen.

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 Verhalten von Blockly 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.

Detaillierte Anleitung

Dies sind die allgemeinen Schritte, die Sie bei jeder Änderung ausführen.

  1. Installieren Sie Git und Node, indem Sie den Links im Abschnitt Tools folgen.
  2. Verzweigen und klonen Sie das Repository. GitHub bietet eine wunderbare Anleitung zum Verzweigen eines Repositorys. Wenn Sie es auf Block anwenden möchten, ersetzen Sie einfach jede Instanz von octocat/Spoon-Knife durch google/blockly oder google/blockly-samples, je nachdem, in welchem Repository Sie arbeiten möchten.
  3. Gabel synchronisieren GitHub bietet auch eine Anleitung zum Synchronisieren einer Gabel.
  4. Sehen Sie sich den Hauptzweig an. In einem Blockkern ist dies der develop-Zweig. In Blockly-Samples ist dies der master-Zweig.
  5. Installieren Sie Abhängigkeiten und erstellen Sie Tools durch Ausführen von npm install im Stammverzeichnis.
  6. Erstellen Sie einen neuen Zweig, indem Sie git checkout -b myBranchName in einem Terminal ausführen. Der Name sollte dir dabei helfen, dich daran zu erinnern, woran du gerade arbeitest.
  7. Nehmen Sie die gewünschten Änderungen vor.
  8. Prüfen Sie Ihre Änderungen gemäß der Anleitung für Kern oder Beispiele.
  9. Speichern Sie Ihre Änderungen mit git commit -am "fix: My commit message". Weitere Informationen zu Commit-Nachrichten
  10. Übertragen Sie die Änderungen mit git push origin myBranchName an GitHub.
  11. Öffnen Sie eine Pull-Anfrage, sobald der Code bereit ist. Ein Mitglied des Blockly-Teams wird Ihre Änderungen prüfen und nach Genehmigung in Blockly zusammenführen. Weitere Informationen finden Sie unter PR-Überprüfungsprozess.