ScratchX の Extension をローカルで開発する環境を整える #Scratch

ScratchX ?

ScratchX には Scratch の拡張ブロック (Extension) を作る機能がある(まだベータ)。
- 簡単に言うと Scratch に自分で作った(JS で書いた)ブロックを追加できる
- ソフトウェアだけで閉じたブロックや Arduino とかのハードウェアに繋がるブロックも作れる

詳しくは https://github.com/LLK/scratchx/wiki を参照。

今回やること

ScratchX の Extension の JavaScript スクリプトはどこかのサーバーに置いて ScratchX に読み込ませる必要がある。

公式のガイド (https://github.com/LLK/scratchx/wiki) によると Github Pages を使うことが推奨されている。

しかし、少しプログラムを変更する度に毎回 Github に push するのは面倒なのでもっと簡単に開発する方法が欲しい。

幸いなことに ScratchX は localhost からのスクリプトの読み込みができるため、自分のマシン上にサーバーを立ててそこから読み込ませるようにする。

今回はその環境を作って簡単なブロックを作るところまでやる。

コマンドラインを使う所が出てきますが、詳しく分からなくても大丈夫なように基本的にコピペでできるようにします。

環境を構築した環境

MacBook Pro (Retina, 13-inch、Early 2015)
OS X Yosemite 10.10.5

必要なもの

node
- JavaScript を動かす環境
- homebrew の環境下なら brew install node でインストールできる
- それ以外の場合は node インストール mac とかでググッてインストールする
エディタ
- なんでも構いませんが atom が最近の流行りっぽいです
- トップページの動画が SF 好きには好評なやつです

サンプルとして作る Extension

今回はローカルで開発する環境を作るのがメインなので難しい Extension は作らず、ログを出力するだけのものを作ります。

完成のイメージとしては指定した文字をアラートで出す感じです。

アラートの代わりに console.log を使うことでデベロッパーツールをログを出すこともできます。

実際に作る

前置きが長くなりましたが実際に作っていきましょう。

プロジェクトのフォルダを作る

まずはプロジェクトのフォルダを作ります。

好きなところに scratchx_log というフォルダを作りましょう。

そして、その中に src というフォルダを作りましょう。

src の中にソースコードを入れていきます(source code の src です)。

こんな感じになっていれば大丈夫です。

crossdomain.xml を作る

crossdomain.xml というものを作ります。

詳しい説明は省きますが ScratchX に自分で作った Extension の JavaScript を読みこませるために必要なファイルです。

内容については何も分からなくて大丈夫なので以下の xml をコピペして src フォルダの中に crossdomain.xml という名前で保存しましょう。

crossdomain.xml

<cross-domain-policy xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.adobe.com/xml/schemas/PolicyFile.xsd">
  <site-control permitted-cross-domain-policies="master-only"/>
  <allow-access-from domain="scratchx.org"/>
  <allow-access-from domain="llk.github.io"/>
</cross-domain-policy>

以下の様な感じになっていれば大丈夫です。

log_extension.js を作る

次に Extension の JavaScript ファイルを作ります。

ここに書いた内容が Scratch に表示されます。

ちょっと長いですが、これもエディタで src フォルダの中に log_extension.js という名前で保存します。

面倒だったらコピペしてみてください。

log_extension.js

(function(ext) {

  // コメントは補足の説明なので書かなくてもいいです

  // Extension が終了するときに呼ばれる
  // 今は特に何もしない
  ext._shutdown = function() {};

  // Extension の状態を返す
  // デバイスが繋がっていないときにはエラーを返したりする
  // ---
  // 返す値, 表示される色, 意味
  //      0,          red, error
  //      1,       yellow, not ready
  //      2,        green, ready
  // ---
  // 今回はデバイスなどは使用しないので常に準備完了
  // ということで 2 を返します。
  ext._getStatus = function() {
    return {status: 2, msg: 'Ready'};
  };

  // この関数がブロック処理になります。
  ext.log = function(str) {
    // ログを出力するだけ
    alert(str);
  };

  // ブロックをどういう風に表示するかを書きます
  // ここの書き方は結構難しいので今は説明しません
  var descriptor = {
    blocks: [
      [' ', 'log %s', 'log', 'sample log']
    ]
  };

  // Scratch に作ったブロックを登録します
  ScratchExtensions.register('Log Extension', descriptor, ext);
})({});

こんな感じになっていれば大丈夫です。

これで Extension の開発は完了です。

次からは作った Extension を ScratchX に読み込ませる作業をしていきます。

ローカルサーバーを起動する

ここから少し難しい作業が続きますが、基本的にはコピペしていくだけなので頑張ってみてください。

まずは package.json というファイルを作ります。

これは nodejs という環境で使う設定ファイルのようなものです。

今回はコレにローカルサーバーの設定を書き簡単にサーバーを立ち上げられるようにします。

内容に関しては分からなくて大丈夫なので以下のソースコードをコピペして scratchx_log フォルダに package.json という名前で保存します(src の中ではないので注意)。

package.json

{
  "name": "scratchx_log",
  "version": "1.0.0",
  "description": "ScratchX のサンプルプロジェクトです。",
  "main": "index.js",
  "scripts": {
    "start": "http-server -c-1 src",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "MIT",
  "dependencies": {
    "http-server": "^0.9.0"
  }
}