開発ツール

Blockly は、Git、npm、Closure Compiler など、開発用のいくつかのツールとライブラリを使用します。このセクションでは、各ツールの基本的な説明と、各ツールに関する詳細情報へのリンクを示します。

こうしたツールの多くをスクリプトで使用しています。直接実行する必要はありません。名前がわかっていれば、問題や機能リクエストのデバッグや提出に役立ちます。

Git

Git は、ファイルへの変更を追跡および管理するために使用するバージョン管理システムです。

GitHub

GitHub は、オープンソース コードのバージョン管理、コラボレーション、配布のためのホスティング プラットフォームです。Git はファイルを追跡します。GitHub は、コードの確認、問題の追跡、変更履歴の表示を行うためのスムーズなインターフェースを提供します。

スタートガイド: Git と GitHub を初めて使用する場合は、GitHub のクイックスタートのチュートリアルを参照して基本を理解してください。

ノード

Node.js を使用すると、(ブラウザではなく)サーバーで JavaScript を実行できます。npm(下記参照)は Node で実行されます。

npm

npm は次の 2 つです。

  • 依存関係のインストールとスクリプトの実行に使用するコマンドライン ツール。
  • Google がコードを公開するオンライン レジストリです。これにより、他のデベロッパーが簡単に Blockly を使用できます。

スタートガイド: Node と npm をインストールします。

クロージャ コンパイラ

Closure Compiler は、JavaScript のダウンロードと実行を高速化するためのツールです。これを使用して、すべての JavaScript ファイルを 1 つのライブラリにまとめます。また、構文や型の確認にも使用します。

スタートガイド: Closure Compiler を直接インストールまたは実行する必要はありません。インストールして実行するのは npm です。

詳細: JavaScript の型型のアノテーションに関するクロージャ コンパイラのドキュメントがあります。

ESLint

ESLint は、JavaScript コードの問題を検出する静的アナライザです。これを使用して、コードベース全体に一貫したスタイルを定義し、適用します。コード上の小さな問題(セミコロンの欠落、スペースの不一致など)は、多くの場合 lint と呼ばれます。pull リクエストを送信すると、ESLint が自動的に実行されます。ローカルで実行することもできます。

スタートガイド: Blockly コアとブロックサンプルの両方で、npm run lint を使用して ESLint を実行できます。多くのコードエディタには、入力時に問題を示す ESLint 統合も用意されています。

詳細: 各 ESLint ルールには、ルールを説明するドキュメント ページがあり、正しいコードと正しくないコードの例を示しています。

モカ

Mocha は JavaScript テスト フレームワークです。これを使用して、ブラウザと Node.js でテストを実行します(ヘッドレスのユースケースの場合)。

スタートガイド: Blockly のコアとブロックのサンプルの両方で、npm run test を使用して Mocha テストを実行できます。Blockly Core では、他のテストも実行します。Blockly コアの Mocha テストは、tests/mocha ディレクトリで定義されます。

詳細: Mocha ではデベロッパーがフックを定義できます。これを使用して、テストの一元化されたセットアップおよびティアダウン関数を定義できます。

チャイ

Chai は、Mocha テストで使用するアサーション ライブラリです。

詳細: Chai には複数の「フレーバー」構文があるため、既存のプロジェクトとの統合が容易になります。Blockly では assert フレーバーを使用します。