「IronRuby」を編集中

'''IronRuby'''とは、[[マイクロソフト]]の[[DLR]]開発チームの中の人が作った[[.NET Framework]]上で動作する[[Ruby]]の実装である。
もともとはマイクロソフトによって管理されていたが、[[IronPython]]とともにオープンソースコミュニティに譲渡され、ユーザーコミュニティにより開発と管理がなされている。

== 互換性 ==
2012年3月時点で最新のIronRuby 1.1.3 は、Ruby 1.9.2 互換となっており、Ruby 1.8.6 との互換性は捨てられている。

Ruby 1.8.6 との互換を希望するユーザーのために IronRuby 1.0 も継続して提供されているので、必要ならばそちらを使うこと。

== インストール ==

=== Windows ===
公式サイトからインストーラをダウンロードして実行。

==== 注意事項 ====
[[RubyGems]]はIronRubyをインストールしたディレクトリの中の「\Lib\ruby\gems\」ディレクトリ以下に配置されるため、IronRubyをデフォルトのままProgram Filesディレクトリにインストールすると、[[Windows Vita]]以降のセキュリティ制限により動かないので注意すること。

また、[[RubyGems]]の中には[[nmake]]を用いる物も多々ある。nmakeは単品配布<ref>http://d.hatena.ne.jp/perlcodesample/20081025/1225035398</ref>、もしくはVisual Studio同梱の物を使うと良い。なお、nmakeへのパスが通っていないと次々とエラーがでることになる。[[Visual Studio]]同梱版の場合は[[cmd.exe]]起動時に一式のパスを通してくれる「Visual Studio コマンドプロンプト」というスタートメニューの中にあるショートカットから起動するという手もある。

=== Mono ===
以下は2012年3月14日時点でのインストール方法です。
URLなど、IronRubyのバージョンはIronRuby 1.1.3（Ruby 1.9.2互換）を対象としています。

基本的にはzipファイルをダウンロードしてきて展開するだけです。

<source lang="bash">
# ダウンロード
$ wget --content-disposition "http://download.codeplex.com/Download?ProjectName=ironruby&DownloadId=217153&FileTime=129445296766130000&Build=18559"

# 展開
$ unzip IronRuby.zip -d /opt/ironruby

# ショートカット用のシェルスクリプトを用意しておく
$ echo '#!/bin/sh'$'\nexec mono $MONO_OPTIONS "/opt/ironruby/bin/ir.exe" "$@"' > /opt/ironruby/bin/ir
$ chmod 755 /opt/ironruby/bin/ir
</source>

gemが動かない。

{{stub}}

=== Mono（ソースコードから） ===
以下は2012年03月09日時点でのインストール方法であり、今後変更になる可能性がある。


1. [[GitHub]]から[[ソースコード]]を[[ダウンロード]]する。

<!--
GitHubのサイト上からブラウザでダウンロードするもよし、gitでダウンロードするもよし。
なお、IronLanguageプロジェクトの全ソースコードがダウンロードされるので[[IronPython]]のソースコードも含まれている。
<source lang="bash">
$ mkdir iron
$ cd iron
$ git clone https://github.com/IronLanguages/main.git
</source>
-->
[[GitHub]]のサイト上から[[ブラウザ]]で[[ダウンロード]]して展開する。
<source lang="bash">
$ wget "https://github.com/IronLanguages/main/zipball/v1.1.3"
$ unzip v1.1.3
$ cd IronLanguages-main-93ce72d/
</source>

2. ファイル名の大文字小文字を統一する。

ソリューションファイルの中で指定されている各種ファイルが、ファイルの大文字小文字を区別しないWindows向けに作られており、ファイル名の大文字小文字を区別するLinux/Unixでは「ファイルがない」などのエラーとなるので統一する。
<source lang="bash">
$ find . -type f -name *.sln -exec sed -i.bak 's/SilverLight/Silverlight/g' '{}' \;
</source>


3. [[xbuild]]コマンドでビルドする。

デフォルトで警告をエラーとするTreatWarningsAsErrorsが有効になっているので無効化した状態でビルドする。
<source lang="bash">
$ xbuild /p:Configuration=Release /p:TreatWarningsAsErrors=false Solutions/Ruby.sln
</source>


4. [[Ruby]]標準ライブラリのパスを書き換えておく。

※下記ではインストール先を「/opt/ironruby/」ディレクトリとしているので適宜書き換えること。

Ruby標準ライブラリのパスはApp.configに記載されているので適宜書き換える。
ここでは実行ファイルの在処の中に配置する。
<source lang="bash">
$ find bin/ -name *.config -exec sed -i.bak 's/\.\.\\.\.\\Languages\\Ruby\\StdLib/StdLib/g' '{}' \;
</source>

5. 出来上がったファイルをコピーする。

※下記ではインストール先を「/opt/ironruby/」ディレクトリとしているので適宜書き換えること。

実行ファイル。
<source lang="bash">
$ mkdir -p /opt/ironruby/lib
$ cd bin/Release
$ for f in *.exe *.dll *.config; do \
    install $f /opt/ironruby/lib; \
  done
$ cd ../../ 
</source>

ライブラリ。
<source lang="bash">
$ cp -R Languages/Ruby/StdLib /opt/ironruby/lib/
</source>

gemなどの各種スクリプト。
<source lang="bash">
$ for f in Languages/Ruby/Scripts/bin/*; do \
    install $f /opt/ironruby/bin; \
  done
</source>


6. ショートカット用のシェルスクリプトを作っておく。

※下記ではインストール先を「/opt/ironruby/bin」ディレクトリとしているので適宜書き換えること。
<source lang="bash">
$ mkdir -p /opt/ironruby/bin
$ echo '#!/bin/sh'$'\nexec mono $MONO_OPTIONS "/opt/ironruby/lib/ir.exe" "$@"' > /opt/ironruby/bin/ir
$ chmod 755 /opt/ironruby/bin/ir
</source>


7. IronRubyを起動してみる

<source lang="bash">
$ cd /opt/ironruby/bin
$ ./ir
>>> puts 'hello ironruby'
hello ironruby
=> nil
>>> （Ctrl-Dで終了）
</source>


まだgemが動かせていない。
Windowsのigem.batは動くんだがねぇ。

{{stub}}

== IronRuby Tools ==
{{stub}}

== RubyGems ==
IronRubyでRubyGemsを使うには「ir -S gem」コマンドを使う。このコマンドをバッチファイルにしたigem.batという物もあるのでそちらを使っても良い。

=== 簡単な使い方を表示する ===
引数を省略すると簡単なヘルプが表示される。
全コマンドが表示されるわけではないので注意すること。
<source lang="dos">
igem
</source>

基本的には本家[[Ruby]]のgemコマンドとほぼ同じなので、詳細はRubyGemsの公式サイト上のドキュメントを見ておくとよい。
* http://docs.rubygems.org/

=== 標準パッケージをアップデートする ===
igemコマンドに「--no-ri --no-rdoc」というオプションを付けることでドキュメントの生成を抑制する。
RubyGemsのインストールやアップデートのうち、大半の時間はドキュメント生成なので、このオプションを付けることで驚くほど高速化することができる。

また、「-V」オプションを付けることで途中経過を表示することができる。通常は正常終了するか異常終了するまで何も画面にでないので本当に動いているか不安になるので、極力付けた方がよい。
<source lang="dos">
igem update --system --no-ri --no-rdoc -V
</source>

=== インストールされているパッケージの一覧を表示する ===
<source lang="dos">
igem list --local
</source>

=== RubyGemsで配布されているパッケージの一覧を表示する ===
なお、RubyGemsで配布されているパッケージは膨大な数にのぼるので、とてつもなく時間がかかる。
<source lang="dos">
igem list --remote
</source>

=== パッケージをインストールする ===
たとえばrakeをインストールする場合は以下のようにする。
<source lang="dos">
igem install rake -V --no-ri --no-rdoc
</source>

== 関連項目 ==
* [[IronPython]]
* [[Dynamic Language Runtime]]

== 外部リンク ==
* http://ironruby.net/ - 公式サイト
* https://github.com/IronLanguages/ - 公式リポジトリ
* https://github.com/IronLanguages/main/tree/master/Languages/Ruby - 公式リポジトリ内のIronRuby本体のソースコード

== 参考文献 ==
<references/>

{{stub}}