非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 での 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
-
workspace API トークンを作成し、その値をコピーします。
トークンには、少なくとも viewer の workspace ロールを付与してください。これは Build Cache にアクセスできる最も低いロールです。
-
Workspace ID を確認します: Workspace settings ページを開き、左側のナビゲーションメニューで General settings を選択します。そこでスラッグを確認してコピーできます。
-
CI の設定で、次の Environment Variables を設定します。
BITRISE_BUILD_CACHE_AUTH_TOKEN: workspace API のト ークン。BITRISE_BUILD_CACHE_WORKSPACE_ID: Bitrise workspace のスラッグ。
-
高速化したいステップの前に、次のスクリプトを CI の設定に追加します。
Environmentスクリプトは、高速化したい Xcode コマンドと同じ環境で実行してください。
他のビルドツール (たとえば Gradle) 用のワークフローがすでに設定されている場合は、Xcode をサポートする最新の CLI バージョン (v1.0.0 以降) をインストールしてください。
Xcode Compilation Cache には Xcode 26 or later バージョンが必要です。
#!/usr/bin/env bashset -euxo pipefail# download Bitrise Build Cache CLIcurl --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