メインコンテンツまでスキップ

非Bitrise CI環境でのBuild Cache for Xcodeの設定

Bitrise Build Cache は、Bitrise CI の使用を必須としません。他の CI/CD サービスを使用しながら、キャッシュを活用して Xcode ビルドの時間を短縮できます。

そのためには、ビルド中に Bitrise Build Cache CLI をダウンロードするよう CI 環境を設定し、その後 CLI を実行して Bitrise Build Cache を有効にします。

手動で手順を進める代わりに、AIコーディングエージェントを使ってセットアップすることもできます。AIで始めるを参照してください。

GitHub Actions の使用

GitHub Actions のワークフロー例を掲載した専用ガイドがあります。GitHub Actions での Build Cache for Xcode の設定を参照してください。

Bitrise Build Hub ランナーでは、トークンはまったく必要ありません。マシンはすでに Bitrise Workspace に接続されているため、CLI が自動的に認証を行います。以下の手順は、それ以外のすべての環境が対象です。

トークンの選択Click to copy link​

CI の連携には、workspace API トークンを使用してください。このトークンは個人ではなくworkspaceに属するため、担当者のロールが変わったり退社したりしても、ビルドは引き続き動作します。

Personal Access Tokenも使用できますが、作成したユーザーのロールを引き継ぎ、そのユーザーがworkspaceを離れると動作しなくなります。

ご自身のマシンでは、どちらも必要ありません。CLIがブラウザー経由でサインインし、認証情報をOSキーチェーンに保存します。お使いのビルドツール向けのローカルガイドについては、ローカル開発環境でのセットアップを参照してください。

キャッシュの設定Click to copy link​

  1. workspace API トークンを作成し、その値をコピーします。

    トークンには、少なくとも viewer の workspace ロールを付与してください。これは Build Cache にアクセスできる最も低いロールです。

  2. Workspace ID を確認します: Workspace settings ページを開き、左側のナビゲーションメニューで General settings を選択します。そこでスラッグを確認してコピーできます。

  3. CI の設定で、次の Environment Variables を設定します。

    • BITRISE_BUILD_CACHE_AUTH_TOKEN: workspace API のトークン。
    • BITRISE_BUILD_CACHE_WORKSPACE_ID: Bitrise workspace のスラッグ。
  4. 高速化したいステップの前に、次のスクリプトを CI の設定に追加します。

    Environment

    スクリプトは、高速化したい Xcode コマンドと同じ環境で実行してください。

    他のビルドツール (たとえば Gradle) 用のワークフローがすでに設定されている場合は、Xcode をサポートする最新の CLI バージョン (v1.0.0 以降) をインストールしてください。

    Xcode Compilation Cache には Xcode 26 or later バージョンが必要です。

    #!/usr/bin/env bash
    set -euxo pipefail

    # download Bitrise Build Cache CLI
    curl --retry 5 -sSfL 'https://raw.githubusercontent.com/bitrise-io/bitrise-build-cache-cli/main/install/installer.sh' | sh -s -- -b /tmp/bin -d

    # run the CLI to enable Bitrise build cache for Xcode
    /tmp/bin/bitrise-build-cache activate xcode --cache --cache-push