概要#

flutter開発していて、以下の構成で進めていたが、cocoapodsが不安定になってきたので、gemfileのバージョン固定に乗り換えるためにrbenvの設定方法についてまとめます。

• 元々の構成

• Gemfile構成

fastlaneなどを動かす場合は、同じくGemfileでバージョン固定するのが良さそう

1. Homebrewでrbenvをインストール#

まずはパッケージマネージャーのHomebrewを使って、rbenvと、Rubyのビルドに必要なruby-buildをインストールします。

1
brew update
2
brew install rbenv ruby-build

2. シェルの設定（パスを通す）#

インストールしただけではrbenvは動きません。お使いのシェル（多くの場合はZsh）の設定ファイルに、rbenvを初期化する記述を追加します。

1
echo 'eval "$(rbenv init -)" ' >> ~/.zshrc
2
source ~/.zshrc

Note: Bashを使っている場合は ~/.zshrc を ~/.bash_profile に読み替えてください。

3. Ruby 4.0.1 のインストール#

次に、目的のバージョンをインストールします。

1
# インストール可能なリストを更新
2
brew upgrade ruby-build
3

4
# 4.0.1 がリストにあるか確認
5
rbenv install -l | grep 4.0.1
6

7
# インストール実行
8
rbenv install 4.0.1

4. バージョンの切り替え#

インストールが終わったら、PC全体（global）で使うバージョンを4.0.1に固定します。

1
rbenv global 4.0.1
2

3
# 反映を確認
4
ruby -v

1. Bundlerをインストールする#

Ruby 4.0系であれば標準で含まれていることが多いですが、念のため最新をインストールします。

1
gem install bundler

2. Gemfileを自動生成する#

プロジェクトのルートディレクトリ（作業フォルダ）に移動して、以下のコマンドを叩きます。

1
bundle init

これだけで、カレントディレクトリに Gemfile という名前のファイルが作成されます。

3. Gemfileの中身を編集する#

生成された Gemfile をテキストエディタで開き、必要なライブラリを記述します。

1
# frozen_string_literal: true
2

3
source "https://rubygems.org"
4

5
# 使用するRubyのバージョンを指定（チーム開発で役立ちます）
6
ruby "4.0.1"
7

8
# インストールしたいGemをここに書く
9
gem "rails"
10
gem "sqlite3"

4. ライブラリをインストールする#

記述が終わったら、ターミナルで以下のコマンドを実行します。

1
bundle install

これにより、Gemのインストールと同時に Gemfile.lock というファイルが生成されます。これは「どのバージョンのGemをインストールしたか」を正確に記録する重要なファイルです。