Rubyマネージャおよびインストーラ

GraalVMをインストールした場合は、TruffleRubyをRubyマネージャに追加することをお薦めします。後述の「完全なGraalVMディストリビューションのためのRubyマネージャの構成」を参照してください。

RVM、ruby-buildまたはruby-installを使用したTruffleRubyのインストール

TruffleRubyは、3つの主要なRubyインストーラによってサポートされます。

RVM

RVMをアップグレードして、RVMに最新のTruffleRubyリリースを通知します:

rvm get head

次のようにして最新のTruffleRubyリリースをインストールします:

rvm install truffleruby

次のようにして、TruffleRubyの最新のナイトリ・ビルドをインストールすることもできます:

rvm install truffleruby-head

ruby-buildおよびrbenv

rbenvのプラグインとしてruby-buildがすでにインストールされていることを前提としています。

まず、ruby-buildをアップグレードして、最新のTruffleRuby定義を取得する必要があります。ruby-buildのアップグレードの手順を参照してください。

macOSでは、ruby-buildがHomebrewを介してインストールされていて、最新のTruffleRubyリリースが表示されない場合、ruby-buildのHEADバージョンを次のようにインストールする必要があります:

brew reinstall --HEAD ruby-build

次のようにしてTruffleRubyの最新の使用可能なバージョンを確認します:

rbenv install --list | grep truffleruby

次に、次のようにして最新のTruffleRubyリリースをインストールします:

rbenv install truffleruby-[LATEST_VERSION]

次のようにして、TruffleRubyの最新のナイトリ・ビルドをインストールすることもできます:

rbenv install truffleruby-dev

ruby-installおよびchruby

まず、TruffleRubyサポートを受けるには、少なくともruby-install 0.7.1が必要です。次のようにしてバージョンを確認します:

ruby-install --version

0.7.1より古い場合は、最新のruby-installに更新する必要があります。ruby-installをアップグレードするステップはインストールするステップと同じであるため、インストール手順に従います。

次に、次のようにして最新のTruffleRubyリリースをインストールします:

ruby-install --latest
ruby-install truffleruby

ruby-installでは、ナイトリ・ビルドのインストールはサポートされていません。ナイトリ・ビルドをインストールする場合は、ruby-build (chrubyでも動作します)を使用してください:

ruby-build truffleruby-dev ~/.rubies/truffleruby-dev

TruffleRubyを手動でインストールする場合は、chruby wikiにも手順があります。

完全なGraalVMディストリビューションのためのRubyマネージャの構成

GraalVMおよびRubyをインストールする場合、使いやすくするためにTruffleRubyをRubyマネージャに追加することをお薦めします。

GraalVMをRubyマネージャに追加する前に、インストール後スクリプトを実行したことを確認してください。

その後、次のステップに従って、GraalVMをRubyマネージャに統合します。

最初のステップでは、TruffleRubyホームを見つけます。macOSでは、次を実行します:

ruby_home=$(path/to/graalvm/Contents/Home/bin/ruby -e 'print RbConfig::CONFIG["prefix"]')

Linuxおよびその他のプラットフォームでは、次を実行します:

ruby_home=$(path/to/graalvm/bin/ruby -e 'print RbConfig::CONFIG["prefix"]')

rbenv

TruffleRubyをrbenvに追加するには、rbenvのversionsディレクトリにシンボリック・リンクを作成します:

ln -s "$ruby_home" "$RBENV_ROOT/versions/truffleruby"
rbenv shell truffleruby
ruby --version

chruby

TruffleRubyをchrubyに追加するには、$HOME/.rubiesディレクトリへのシンボリック・リンクを作成します:

ln -s "$ruby_home" "$HOME/.rubies/truffleruby"
chruby truffleruby
ruby --version

RVM

RVMには、使用可能なrubiesのリストにプリコンパイル済のRubyを追加するためのコマンドがあります:

rvm mount "$ruby_home" -n truffleruby
rvm use ext-truffleruby
ruby --version

asdf (asdf-rubyプラグインを使用)

asdf関数にTrufflerubyを追加すると、rbenvやchrubyと同様に、.installs/rubyディレクトリにシンボリック・リンクが作成されますが、reshimする必要もあります:

ln -s "$ruby_home" "$HOME/.asdf/installs/ruby/truffleruby"
asdf reshim ruby truffleruby
asdf local ruby truffleruby
ruby --version

RubyマネージャなしでのTruffleRubyの使用

rvm、rbenv、chrubyなどのRubyマネージャを使用し、そのいずれにもTruffleRubyを追加しない場合は、マネージャに環境変数GEM_HOMEおよびGEM_PATHが設定されていないことを確認してください。変数は、(他のRuby実装と同様に) TruffleRubyによって取得されるため、TruffleRubyは独自のgemホームではなく間違ったgemホームを選択します。

次のいずれかのコマンドを使用して環境をクリアすることで、現在の端末に修正できます:

rbenv system
chruby system
rvm use system
# Or manually:
unset GEM_HOME GEM_PATH