Entwicklungstools

Blockly verwendet einige Tools und Bibliotheken für die Entwicklung, einschließlich Git, npm und dem Closure Compiler. In diesem Abschnitt finden Sie einige grundlegende Beschreibungen der einzelnen Tools sowie Links zu weiteren Informationen zu den einzelnen Tools.

Viele dieser Tools werden mithilfe von Skripts eingesetzt. Sie müssen sie nicht direkt ausführen. Die Kenntnis der Namen kann dennoch hilfreich sein, um Fehler zu beheben, Probleme zu melden oder Funktionsanfragen zu senden.

Git

Git ist ein Versionskontrollsystem, mit dem wir Änderungen an Dateien verfolgen und verwalten.

GitHub

GitHub ist eine Hostingplattform für Versionsverwaltung, Zusammenarbeit und Verteilung von Open-Source-Code. Git verfolgt die Dateien. GitHub bietet reibungslose Schnittstellen zum Überprüfen von Code, Verfolgen von Problemen und Aufrufen des Änderungsverlaufs.

Erste Schritte: Wenn Sie noch nicht mit Git und GitHub vertraut sind, können Sie sich mit den Grundlagen vertraut machen. Sehen Sie sich dazu die quickstart von GitHub an.

Knoten

Node.js ist eine Möglichkeit, JavaScript auf dem Server (statt in einem Browser) auszuführen. npm (siehe unten) wird auf Node ausgeführt.

npm

npm ist zwei Dinge:

  • Ein Befehlszeilentool, mit dem wir Abhängigkeiten installieren und Skripts ausführen.
  • Eine Online-Registry, in der wir unseren Code veröffentlichen, was die Verwendung von Blockly für andere Entwickler erleichtert.

Erste Schritte: Installieren Sie Node und npm.

Closure-Compiler

Der Closure Compiler ist ein Tool, mit dem JavaScript schneller heruntergeladen und ausgeführt werden kann. Wir kombinieren damit alle unsere JavaScript-Dateien in einer einzigen Bibliothek und prüfen damit auch Syntax und Typen.

Erste Schritte: Sie müssen den Closure Compiler nicht direkt installieren oder ausführen. Wir installieren ihn über npm und führen ihn aus.

Weitere Informationen: Dokumentation zum Closure-Compiler zu JavaScript-Typen und Typannotationen.

ESLint

ESLint ist ein statisches Analysetool, das Probleme mit JavaScript-Code findet. Wir verwenden es, um einen einheitlichen Stil auf unserer Codebasis zu definieren und zu erzwingen. Kleine Codeprobleme (fehlende Semikolons, uneinheitliche Abstände usw.) werden oft als Lint bezeichnet. ESLint wird automatisch ausgeführt, wenn Sie uns eine Pull-Anfrage senden. Sie können es auch lokal ausführen.

Erste Schritte: Sowohl in Blockly Core als auch Blockly-Beispielen können Sie ESLint mit npm run lint ausführen. Viele Codeeditoren haben auch ESLint-Integrationen, um Probleme während der Eingabe anzuzeigen.

Weitere Informationen: Zu jeder ESLint-Regel gibt es eine Dokumentationsseite mit einer Beschreibung der Regel und Beispielen für richtigen und falschen Code.

Mokka

Mocha ist ein JavaScript-Testframework. Wir verwenden sie, um Tests im Browser und auf Node.js (für monitorlose Anwendungsfälle) durchzuführen.

Erste Schritte: Sowohl in Blockly Core- als auch Blockly-Samples kannst du unsere Mocha-Tests mit npm run test ausführen. Im Blockly Core werden hierbei auch andere Tests ausgeführt. Die Mocha-Tests von Blockly Core sind im Verzeichnis tests/mocha definiert.

Weitere Informationen: Mit Mocha können Entwickler Hooks definieren, mit denen Sie zentralisierte Einrichtungs- und Teardown-Funktionen für Ihre Tests definieren können.

Chai

Chai ist eine Assertion-Bibliothek, die wir in unseren Mocha-Tests verwenden.

Weitere Informationen: Chai hat mehrere "Varianten" der Syntax, um die Integration in vorhandene Projekte zu vereinfachen. Blockly verwendet den assert-Geschmack.