はじめに

この記事では、スモウルビーの開発に必要なソフトウェアをWindows 10にインストールする手順を説明します。

対象とするOSはWindows 10で、この記事を書いた時点で最新のWindows Updateを適用済みのものを対象とします。

この記事でインストールするソフトウェアは次のものです。各種ファイルのダウンロード先はどこでも問題ないとは思いますが、この記事ではデスクトップを指定しています。

7-Zip 16.04 (2016-10-04) 32-bit x86
MSYS2 x86_64-20180531
ruby 2.4.6-1(x86)
- RubyInstaller for Windows で配布されているものを使います。
- 2.4以降のものであれば、おそらく同じ手順でバージョンだけを変えればインストールできるのではないかと思います。もしインストールに失敗する場合はコメント等で教えていただけますと幸いです。
Git 2.14.2 (MSYS2)
bundler 1.15.4
DXRuby 1.4.5
smalruby3 0.0.1

スモウルビーのインストール先は、Cドライブ直下の「smalruby」フォルダとします。

インストール

それでは、順番にソフトウェアをインストールしていきます。

なお、この記事の「\」記号は半角の「￥」記号に読み替えてください。

7-Zip

この記事では7-ZIP形式で圧縮して配布されているrubyを利用します。そのため、まずは7-ZIP形式のファイルを展開するためのソフトウェア 7-Zip をインストールします。

7-Zip から次のソフトウェアをダウンロードします。

7-Zip 16.04 (2016-10-04) 32-bit x86

ダウンロードしたファイルを実行します。このとき、ユーザーアカウント制御のダイアログに警告が表示されます。「プログラムの場所」が先程ダウンロードしたファイルと一致することを確認して、「はい」を選びます。

すると、7-Zip 16.04 Setupダイアログが表示されますので、「Install」ボタンを押します。少し待つとインストールが完了して、「Close」ボタンが表示されますので、「Close」ボタンを押します。

これで、7-Zipのインストールができました。

さらに、インストールした7-Zipと拡張子7zを関連付けます。
スタートメニューから「7-Zip」 - 「7-Zip File Manager」を選択して7-Zipを起動します。

7-Zipのメニューの「ツール」-「オプション」を選びます。

オプションダイアログの「システム」タブの一覧の「種類」-「7z」の自分のアカウント名(スクリーンショットではkouji)をクリックします。すると、「7-Zip」と表示されます。この状態でOKボタンを押します。これで、7-Zipと拡張子7zのファイルを関連付けることができました。

これで、これからダウンロードするrubyを展開できるようになりました。

MSYS2

MSYS2 installerで配布されているOne click installer for msys2を利用して、MSYS2をインストールします。

スモウルビーのインストールに必要となるソフトウェアのいくつかは、MacやLinux等のWindows以外のOS向けに作られています。それらをWindowsでも動作できるようにするソフトウェアがMSYS2です。

msys2-x86_64-20180531.exe をダウンロードし、実行します。MSYS2 64bitのセットアップダイアログの指示に従ってインストールします。まずは次へボタンを押します。

次のダイアログではあらかじめ入力されている 「C:\msys64」を「C:\smalruby\msys64」に変えてから 次へボタンを押します。

次のダイアログは、そのまま次へボタンを押します。

すると、ファイルのコピーが始まります。コピーするファイルがとても多いため、インストールにはしばらく時間がかかります。

ファイルのコピーが終わると完了ボタンが表示されます。「MSYS2 64bit を実行中」をチェックした状態で完了ボタンを押します。

すると、黒い画面のウインドウが表示されます。これがMSYS2の画面です。

ここからは、この画面にキーボードでコマンドを入力してコンピュータを操作します。

まずは、

pacman -Syu

と入力して、最後にEnterキーを押して、コマンドを実行します。

「インストールを行いますか？[Y/n]」と表示されたら、何も入力せずにEnterキーを押します。

しばらくして、以下のように表示されたらMSYS2のウインドウのXボタンを押して閉じます。理由は分かりませんが、簡単に閉じることはできず、強制的に閉じますか的なダイアログが表示されるので、何度かXボタンを押して強制的にウインドウを閉じます。

もう一度、MSYS2を起動します。スタートメニューから「MSYS2 64bit」-「MSYS2 MSYS」を選びます。
先程のコマンドと似ていますが、今度は、

pacman -Su

というコマンドを実行します。

「インストールを行いますか？[Y/n]」と表示されたら、何も入力せずにEnterキーを押します。

しばらくして、「$」と表示されてカーソルが点滅していたらMSYS2のインストールは完了です。Xボタンを押してMSYS2を終了させます。

ruby 2.4.6

RubyInstaller for Windows の Downloadページの Other Useful Downloadsの一覧から、

7-ZIP ARCHIVES
- Ruby 2.4.6-1(x86)

をダウンロードします。

ダウンロードした rubyinstaller-2.4.6-1-x86 をダブルクリックして、7-Zipで開きます。

ツールバーの展開ボタンをクリックします。

コピーダイアログが表示されるので、あらかじめ入力されている 「C:\Users\kouji\Desktop\」を「C:\smalruby」に変えてから、 OKボタンを押します。しばらくすると、すべてのファイルが展開されて、コピーダイアログが自動的に閉じられます。

7-ZIPを終了します。

エクスプローラを使って、展開したフォルダ「rubyinstaller-2.4.6-1-x86」の名前を「ruby_2.4.6-1-x86」に変更します。

スタートメニューから「Windows システムツール」-「コマンドプロンプト」を選び、コマンドプロンプトを起動します。MSYS2と同じようなウインドウが表示されますが、少し見た目が違います。

MSYS2のときと同じように、コマンドを入力してコンピュータを操作します。

.bat

cd \smalruby\ruby_2.4.6-1-x86\bin

すると、画面の表示が次のように変わるはずです。ここで、「指定されたパスが見つかりません。」と表示された場合は、入力したコマンドに間違いがあるか、rubyを展開したり、フォルダの名前を変更する手順が間違っている可能性があります。

次に

.bat

ridk install

を実行します。

すると、次のように表示されますので、「3」を入力して、Enterキーを押します。

しばらくすると、次のように表示されますので、何も入力せずにEnterキーを押します。

最後に、rubyを使えるようにしたコマンドプロンプトを起動するためのバッチファイルを「smalruby」フォルダに「cmd.bat」という名前で作成します。バッチファイルはメモ帳等で次の内容のファイルを作成して、「C:\smalruby\cmd.bat」に保存します。

cmd.bat

@setlocal

call %~dp0ruby_2.4.6-1-x86\bin\ridk.cmd enable

@if not exist "%HOME%" @set HOME=%HOMEDRIVE%%HOMEPATH%
@if not exist "%HOME%" @set HOME=%USERPROFILE%

@cd /d %~dp0
@start %COMSPEC%

(cmd.batのGistはこちら)

今後は、Cドライブの「smalrubu」フォルダにある「cmd.bat」ファイルをダブルクリックするとrubyが使えるようになります。

これで手元のコンピュータでrubyを実行できるようになりましたね。

以降の操作は、cmd.batを使って行います。

Git

TODO: Gitの説明を記述する。一言でOK。

(cmd.batを起動して)次のコマンドを実行します。

.bat

pacman -S git

次のように表示されますので、何も入力せずにEnterキーを押します。

しばらくすると、次のように表示されればインストールは完了です。

bundler

TODO: bundlerの説明

(cmd.batを起動して)次のコマンドを実行します。

.bat

gem install bundler -v 1.16.6

すると、次のダイアログが表示されます。パスが「C:\smalruby\ruby_2.4.2-2-x86\bin\ruby.exe」であることを確認したら、アクセスを許可するボタンを押します。使っているコンピュータによっては、キャンセルボタンしか押せないかもしれません。その場合は、キャンセルボタンを押します。

smalruby3

smalrubyは、Scratchの命令ブロックをRubyのメソッドとして使えるようにするためのライブラリです。例えば、「[10]歩動く」命令ブロックは、Characterクラスの「move」メソッドとして提供しています。

(cmd.batを起動して)次のコマンドを実行します。

.bat

git clone https://github.com/smalruby/smalruby3.git

(以下のように表示されればOK。数値は違うかもしれません。)
Cloning into 'smalruby3'...
remote: Counting objects: 1844, done.
remote: Compressing objects: 100% (10/10), done.
remote: Total 1844 (delta 3), reused 3 (delta 1), pack-reused 1833
Receiving objects: 100% (1844/1844), 1.83 MiB | 220.00 KiB/s, done.
Resolving deltas: 100% (1035/1035), done.

.bat

cd smalruby3

.bat

bundle

(ずらずらと英語が表示されて、最後のあたりに以下のように表示されればOK。数値は違うかもしれません。)
Bundle complete! 11 Gemfile dependencies, 55 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
Post-install message from yard:
--------------------------------------------------------------------------------
As of YARD v0.9.2:

RubyGems "--document=yri,yard" hooks are now supported. You can auto-configure
YARD to automatically build the yri index for installed gems by typing:

    $ yard config --gem-install-yri

See `yard config --help` for more information on RubyGems install hooks.

You can also add the following to your .gemspec to have YARD document your gem
on install:

    spec.metadata["yard.run"] = "yri" # use "yard" to build full HTML docs.

--------------------------------------------------------------------------------

.bat

bundle exec rake spec

(ずらずらと英語や日本語が表示されて、最後のあたりに以下のように表示されればOK。数値は違うかもしれません。)
Finished in 1.08 seconds (files took 4.22 seconds to load)
146 examples, 0 failures

Randomized with seed 58798

[Coveralls] Outside the CI environment, not sending data.

ここでもし、以下のエラーが発生する場合は、本文章の下部にある「付録1. dxruby.soの作り方」を参考にして、dxruby gem の再インストールをしてください。

C:/smalruby/ruby_2.4.2-2-x86/lib/ruby/2.4.0/rubygems/core_ext/kernel_require.rb:133:in `require':LoadError: 126: 指定さ れたモジュールが見つかりません。   - C:/smalruby/ruby_2.4.2-2-x86/lib/ruby/gems/2.4.0/gems/dxruby-1.4.5/lib/2.4/dxruby.so

.bat

bundle exec ruby examples\event.rb

これでねこが左右に往復するサンプルプログラムが動作すればOKです。

.bat

cd ..

これでsmalruby3をインストールできました。また、ソースコードが「C:\smalruby\smalruby3」にあるのでsmalruby3そのものを改修する準備も整いました。

動作確認

smalruby

WIP: 実際にソースコードを編集して、それが反映されたことを確認するための手順を記述する。簡単な命令を追加して、それを実行できるかどうかを確認すればOKですね。