「IronRuby」を編集中

'''IronRuby'''（読み：あいあんるびー）とは、[[マイクロソフト]]の[[DLR]]開発チームの中の人が作った[[.NET Framework]]上で動作する[[Ruby]]の実装である。読み方は「あいあんるびー」であり「あいろんるびー」ではない。

== 概要 ==
IronRubyは元々[[マイクロソフト]]によって管理されていたが、[[IronPython]]と共にオープンソースコミュニティ「[[IronLanguage]]プロジェクト」に譲渡され、現在ではユーザーコミュニティにより開発と管理がなされている。[[ライセンス]]には[[Apache License 2.0]]を採用しており完全なる[[オープンソース]]である。

== 互換性 ==
2012年3月時点で最新のIronRuby 1.1.3 は、Ruby 1.9.2 互換となっており、Ruby 1.8.6 との互換性は捨てられている。Ruby 1.8.6 との互換を希望するユーザーのために IronRuby 1.0 も継続して提供されているので、必要ならばそちらを使うこと。

== インストール ==
=== Windows ===
IronRubyの公式サイトから[[インストーラー]]を[[ダウンロード]]して実行するだけである。

==== 注意事項 ====
[[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互換）を対象としています。

基本的にはIronRubyの公式サイトから[[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」コマンドを使う。

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

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

=== パッケージをインストールする ===
たとえばrakeをインストールする場合は以下のようにする。
<source lang="dos">
ir -S gem install rake
</source>
=== インストールされているパッケージの一覧を表示する ===
<source lang="dos">
ir -S gem list --local
</source>
=== RubyGemsで配布されているパッケージの一覧を表示する ===
なお、RubyGemsで配布されているパッケージは膨大な数にのぼるので、とてつもなく時間がかかる。
<source lang="dos">
ir -S gem list --remote
</source>

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

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

== 参考文献 ==
{{reflist}}

{{stub}}