Skip to main content

Bitrise の Ruby バージョン

概要

いくつかのステップで Ruby が動作する必要があるため、Ruby はすべての Bitrise スタックにプリインストールされています。 .ruby-version ファイルまたはスクリプト ステップを使用して、アクティブな Ruby バージョンを変更できます。

2023 年 8 月 7 日までに Ruby 3.0 以降に移行する

2023 年 8 月 7 日月曜日、Bitrise はすべての Bitrise スタックからサポート終了の Ruby バージョンをすべて削除します。できるだけ早く、遅くとも 2023 年 8 月 7 日月曜日までに Ruby バージョン 3.0 以降に移行することを強くお勧めします。詳細については、こちらをご覧ください 公式フォーラムの投稿

4 つの公式 Bitrise 手順 に頼る ルビー 仕事に。これらは:

サードパーティの手順

Bitrise によって維持されていないサードパーティのステップ - 検証済みのステップとコミュニティのステップ - も Ruby を使用している可能性があります。さまざまなステップの詳細をお読みください。 ステップの種類.

Ruby はすべての製品にプリインストールされています。 スタック.実際のバージョンは システム レポート.ただし、必要に応じて異なる Ruby バージョンを使用できます。 アプリ ニーズ。

ビルドでの Ruby バージョンの管理

特定の Ruby バージョンが必要な場合、それが仮想マシンに確実にインストールされるようにするには、主に 2 つの方法があります。

  • あなたが使用することができます .ruby-version ファイル。この方法をお勧めします。

  • あなたが使用することができます 脚本 Ruby のバージョンをオーバーライドする手順。

.ruby-version ファイルの使用

最良の方法は、単に含めることです .ruby-version リポジトリのルートにあるファイル。ファイルは指定する必要があります バージョン あなたが必要です。

  • CocoaPods インストールの実行 ステップは .ruby-version レポのルートにあるファイル。ステップを実行すると、指定されたバージョンがインストールされ、アクティブ化されます。 Ruby を必要とするすべての Bitrise ステップにこの機能を実装する予定です。

  • などの一般的なバージョン マネージャー ツール Ruby バージョン マネージャーrbenv、 また 空自 ファイルを読み取り、指定されたバージョンを自動的にアクティブ化できます。

バージョン マネージャーをローカルでセットアップする

バージョン マネージャー ツールの 1 つをローカルでセットアップすると、ローカル環境と CI 環境の間で一貫したセットアップを行うことができます。

スクリプト ステップの使用

別の解決策は、 脚本 ワークフローに進み、デフォルトの Ruby バージョンをオーバーライドします。で必要なバージョンを宣言できます RUBY_VERSION 環境変数を変更し、その環境変数を rbenv または ASDF で使用します。

注意

例に示されているメソッドは、変更される可能性がある特定の実装の詳細に依存しています!

    - script:
        title: Activate correct Ruby version
        inputs:
        - content: |-
            #!/bin/bash
            set -ex
            RUBY_VERSION=3.2.2
            
            # Configure rbenv by setting the RBENV_VERSION variable
            envman add --key RBENV_VERSION --value $RUBY_VERSION
            
            # Configure ASDF
            which asdf
            if [[ $? == 0 ]]; then
              asdf install ruby $RUBY_VERSION
              asdf global ruby $RUBY_VERSION
            fi

サポートされている Ruby のバージョン

Ruby のバージョンを変更する前に、必要なツールが必要なバージョンをサポートしていることを確認してください。

  • Fastlane は Ruby 3 をサポートしています つまり、 App Store Connect にデプロイする Delivery を使用して接続する そしてその 追い越し車線 ステップは確実に Ruby 3 をサポートします。

  • CocoaPods の最近のバージョン Ruby3をサポート.ただし、古いレガシー gem は Gemfile またはあなたのポッド Podfile 対応していない可能性があります。通常、gem とポッドを常に最新バージョンに更新し、最初にローカル環境で Ruby のバージョン変更をテストすることをお勧めします。