プラグインをデバッグする

blockly-samples でプラグインを開発するときに、Blockly 自体で対応する変更を加える必要が生じることがあります。ほとんどのプラグインは、 npm レジストリからのブロックで、 npm ですでにリリースされています。これにより、Blockly の変更のデバッグが難しくなります。ブロック単位とブロック単位で変更やテストを行う場合 npm link を使用すると、リリース前の変更を一緒にテストできます。

npm に、コマンドを取得する代わりに、マシンからパッケージを使用するように指示できます。 インストールする必要があります。この方法を使用すると、Blockly のデバッグを容易にするソースマップを利用できます。この方法は、まだ GitHub に push されていないコアの変更に使用できます。

  1. blockly のフォークで、次のようにします。

    $ npm run package
    $ cd dist
    $ npm link
    

    次の手順では、コア Blockly をビルドしてパッケージ化し、パッケージ化されたファイルへのシンボリック リンクを作成します。

  2. ブロックリー サンプルのフォークで、ルートで次のように設定します。

    $ npm link blockly
    

    このステップでは、npm に、 npm からパッケージを取得します。

  3. npm run start をプラグインのディレクトリから実行して、プラグインをテストします。

コアに変更を加える場合は、コアを再ビルドして再パッケージ化する必要があります。

テストが完了したら、blockly-samples のルートレベルで npm ci を実行して、リポジトリの状態をリセットします。