開発ツール

Blockly は、Git、npm、Closure Compiler などのツールとライブラリを開発に使用します。このセクションでは、各ツールの基本的な説明と、各ツールの詳細を確認できるページへのリンクを紹介します。

こうしたツールの多くはスクリプトを通じて使用されています。これらを直接実行する必要がない場合もあります。名前を知っておくと、問題または機能リクエストのデバッグや報告に役立つ場合があります。

Git

Git は、ファイルに対する変更の追跡と管理に使用するバージョン管理システムです。

GitHub

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

スタートガイド: Git と GitHub を初めて使用する場合は、GitHub のquickstart チュートリアルを参照して基本事項をご確認ください。

ノード

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 コアと blockly-samples の両方で、npm run lint を使用して ESLint を実行できます。多くのコードエディタには ESLint との統合もあり、入力時に問題を表示することもできます。

詳細: ESLint の各ルールには、ルールについて説明し、正しいコードと間違ったコードの例が記載されたドキュメント ページがあります。

モカ

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

スタートガイド: Blockly core と blockly-samples の両方で、npm run test を使用して Mocha テストを実行できます。Blockly コアでは他のテストも実行します。 Blockly core の Mocha テストは、tests/mocha ディレクトリに定義されています。

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

チャイ

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

詳細: Chai には複数の「フレーバー」があり、既存のプロジェクトと簡単に統合できます。Blockly は assert フレーバーを使用します。