ツールバージョンの設定

で正確なバージョン番号を定義できます tools プロパティ:

tools:
  nodejs: 22.1.0

これにより、最も確定的な動作と再現性の高いビルドが可能になりますが、インストールには長い時間がかかる可能性があります。

プロジェクトに正確なツールバージョンが必要ない場合は、バージョン番号の一部を定義できます。バージョン番号の一部を指定すると、BitriseはBitriseビルドマシンにプリインストールされているバージョンか、入手可能な最新リリースバージョンのどちらかを確認します

ツールのプレインストール版については、 x.y:installed 構文:

tools:
  ruby: 3.3:installed

これにより、BitriseビルドマシンにどのRuby 3.3パッチバージョンがプリインストールされているかが確認され、そのバージョンが使用されています。プリインストールされたバージョンが部分バージョンと一致しない場合、最も一致するバージョンが実行時にダウンロードされ、インストールされます。ビルドは失敗しません

ツールの最新リリースバージョンについては、 x.y:latest 構文:

tools:
  ruby: 3.3:latest

これにより、Bitriseビルドマシンに何がプリインストールされているかに関係なく、最新の3.3パッチバージョンのRubyがインストールされます。

ツールのバージョン定義は、グローバルに定義することも、1 つ以上のワークフロー専用に定義することもできます。定義する代わりに tools 設定の一番上のプロパティで、1 つまたは複数のワークフローの下にネストします。

キーワードを使用して、特定のワークフローの一部のツールの設定を解除することもできます unset。設定を解除すると、そのワークフローにはツールがインストールされなくなります。設定を解除しても、グローバルコンテキストでは効果がありません。

ワークフロー固有の定義を使用する場合は、次の 3 つの一般的なパターンのいずれかを使用することをお勧めします。

スペシャルを使用することも可能です latest そして installed ツールの最新リリースバージョンまたはインストール数が最も多いバージョンを選択するバージョン文字列:

ザ・ installed value は、ビルド時に最もインストールされていたバージョンを使用することを意味します。

tools:
  ruby: installed

ザ・ latest value は、ビルド時にリリースされた最新バージョンを使用することを意味します。

tools:
  nodejs: latest

に電話してください bitrise tools setup あなたのワークフローから。ツールは設定ファイルまたはバージョンファイルのパスを検索します。パスを指定しない場合、ツールはワーキングディレクトリ内のファイルを検出します。

この例では、からコマンドを呼び出しています スクリプト a を使ったステップ --config を検索するフラグ .tool-versions ファイル。

workflows:
  build-and-test:
    steps:
      # Project stores tool config in a .tool-versions file committed to the repo
      - git-clone: {}
      - script:
          title: Set up environment
          inputs:
            # Set up tools based on the .tool-versions file in the repo
            - content: bitrise tools setup --config .tool-versions
      
      # Rest of the workflow has access to the right tools and versions in $PATH

設定ファイルなしで特定のツールをインストールすることもできます。

bitrise tools install [--provider PROVIDER] [--format FORMAT] <TOOL> <VERSION>[:SUFFIX]

# Examples:
bitrise tools install nodejs 20.10.0
bitrise tools install nodejs 22:latest
eval "$(bitrise tools install ruby 3.2.0 --format bash)"  # activate in shell

デフォルトでは、実行中 bitrise tools setup 同じシェルセッションでツールの変更を有効にしない (例えば、ツールのセットアップとツールの使用が同じシェルセッションで行われる場合) スクリプト ステップ)。この例では、新しい Ruby バージョンをインストールしています。

#! /bin/bash

bitrise tools setup --config .ruby-version

ruby --version

このコマンドを a で実行すると スクリプト ステップ、 PATH 以前のバージョンの Ruby を引き続き指します。

以下を使用して、同じシェルセッションでツールをインストールしてアクティブ化できます。 eval:

eval "$(bitrise tools setup --config .ruby-version --format bash)"

ruby --version # $PATH is updated with the newly set up ruby version

または、実行することもできます bitrise tools setup 別のステップで。

workflows:
  build-and-test:
    steps:
      - git-clone: {}
      - script:
          title: Set up environment
          inputs:
            # Set up tools based on the .tool-versions file in the repo
            - content: bitrise tools setup --config .tool-versions
      
      # Rest of the workflow has access to the right tools and versions in $PATH
      - cocoapods-install: {}

ザ・ 依存関係インストーラー ステップは、ツールのインストールを実行する CLI サブコマンドのラッパーです。複数のタイプのツールバージョンファイルを受け入れます。詳細なリストについては、ステップの説明を参照してください

ステップを使用するには、ツールを必要とするステップの前にワークフローに追加してください。

 steps:
 - activate-ssh-key@4: {}
 - git-clone@8: {}
 - dependency-installer@1:
     inputs:
     - tool_version_file: ".tool-versions"