TruffleRubyのインストール

TruffleRubyをインストールする推奨方法は、Rubyマネージャー/インストーラーを使用することです。はじめにをご覧ください。

バイナリtarballを手動でダウンロードし、展開して、インストール後スクリプトを実行し、TruffleRubyを$PATHに追加することによっても、TruffleRubyをインストールできます。このページでは、tarballをダウンロードした後に必要なURLと追加の手順について説明します。

依存関係 #

TruffleRubyを正しく動作させるには、TruffleRubyの依存関係をインストールする必要があります。

Oracle GraalVMとGraalVM Community Edition #

TruffleRubyとGraalVMには2つのバリアントがあります

Oracle GraalVMは、最高のTruffleRubyエクスペリエンスを提供します。大幅に高速でメモリ効率が高くなっています。
GraalVM Community Editionは、完全にオープンソースです。

Oracle GraalVMは、GraalVM無料利用規約に基づいて利用可能な、OracleからのGraalVMディストリビューションです。

ダウンロードリンク #

ネイティブスタンドアロン #

ネイティブスタンドアロンのリリースは、GitHubで入手できます。ネイティブスタンドアロンは、以下のファイルです。

# Oracle GraalVM Native Standalone
truffleruby-VERSION-PLATFORM.tar.gz
# GraalVM Community Edition Native Standalone
truffleruby-community-VERSION-PLATFORM.tar.gz

開発ビルドも入手できます。
開発ビルド用のプラットフォームは、こちらで入手できますが、これらのビルドは少し古い傾向があります。ネイティブスタンドアロンは、`truffleruby-community-dev-PLATFORM.tar.gz`ファイルです。

JVMスタンドアロン #

ネイティブスタンドアロンのリリースは、GitHubで入手できます。JVMスタンドアロンは、以下のファイルです。

# Oracle GraalVM JVM Standalone
truffleruby-jvm-VERSION-PLATFORM.tar.gz
# GraalVM Community Edition JVM Standalone
truffleruby-community-jvm-VERSION-PLATFORM.tar.gz

開発ビルドも入手できます。JVMスタンドアロンは、`truffleruby-community-jvm-dev-PLATFORM.tar.gz`ファイルです。

ダウンロード後 #

tarballをダウンロードしたら、展開します。展開先のディレクトリを`$EXTRACTED_DIRECTORY`と呼びます。このディレクトリには、`bin/truffleruby`、`lib/truffle`などが含まれている必要があります。

次に、インストール後スクリプトを実行する必要があります。これは、Rubyの`openssl` C拡張機能をシステムのlibsslで動作させるために必要です。スクリプトのパスは次のとおりです。

$EXTRACTED_DIRECTORY/lib/truffle/post_install_hook.sh

その後、`$EXTRACTED_DIRECTORY/bin`を`PATH`に追加し、`ruby`/`gem`/`bundle`/etc.を使用できます。

RubyGemsの設定 #

TruffleRubyが正しい`GEM_HOME`と`GEM_PATH`を使用するように、`GEM_HOME`と`GEM_PATH`が設定されていないことを確認する必要があります。詳細は、RubyマネージャーなしでTruffleRubyを使用するを参照してください。