Bitrise CI環境でのBuild Cache for React Nativeの設定
アクティベーションは、Workflow Editorから、またはbitrise.ymlで直接追加できます。
手順を手動で進める代わりに、AIコーディングエージェントを使ってセットアップすることもできます。Getting started with AIを参照してください。
- Workflow Editor
- Configuration YAML
-
次のものを用意してください。
- 有効なBitrise Build Cacheのトライアルまたはサブスクリプション。サブスクリプションの状況は、Bitrise Build Cache ページで確認できます。
- Build Cacheなしですでに正常にビルドできるReact Nativeプロジェクト (基準となる状態を把握するため)。
- iOS プロジェクトの場合: Xcode 26 or later。
-
Bitrise にアクセスして Log in、左側の Bitrise CI を選択し、プロジェクトを選択します。
-
メインページの Workflows ボタンをクリックします。
-
必要なWorkflowを選択します。
-
ネイティブビルドをトリガーするStepの前に、Build Cache for React Nativeステップを追加します。
たとえば、
yarn、npm、npx、expo、fastlane、または直接のGradle/Xcodeコマンドを実行する Script Stepsの前に追加します。git-cloneの直後 に配置することもできます。 -
特別な理由がない限り、入力はデフォルトのままにしてください。このステップには主に 2 つの入力があります。
- Enable Xcode cache: iOS ビルド向けにBitrise Build Cacheを有効にします。バックグラウンドプロキシが自動的に起動します。
- Enable Gradle cache: Androidビルド向けにBitrise Build Cacheを有効にします。C++ ネイティブモジュールも
ccache経由でキャッシュされ、バックグラウンドのストレージヘルパーが自動的に起動します。
-
ネイティブビルドを呼び出す Script Stepsでは、コマンドの先頭に
bitrise-build-cache react-native runを付けてください。注記公式のBitrise Steps Gradle Runner、Android Build、または Xcode Archive を使ってReact Nativeビルドを実行する場合は、latest versionを使用していることを確認してください。ラッピングは自動的に処理されるため、 入力を変更する必要はありません。
ラッピングの詳細については、Wrapping native build commandsを参照してください。
-
Workflowを保存して、ビルドを実行します。
-
次のものを用意してください。
- 有効なBitrise Build Cacheのトライアルまたはサブスクリプション。サブスクリプションの状況は、Bitrise Build Cache ページで確認できます。
- Build Cacheなしですでに正常にビルドできるReact Nativeプロジェクト (基準となる状態を把握するため)。
- iOS プロジェクトの場合: Xcode 26 or later。
-
ビルドを実行するステップの前に、
activate-build-cache-for-react-nativeStepを追加します。workflows:build-react-native:steps:- activate-ssh-key@4: {}- git-clone@8: {}- activate-build-cache-for-react-native@0: {}# JS dependencies — no wrapping needed.- script@1:title: Install dependenciesinputs:- content: yarn install -
ネイティブビルドをトリガーするコマンドを、CLIでラップします。
注記公式のBitrise Steps Gradle Runner、Android Build、または Xcode Archive を使ってReact Nativeビルドを実行する場合は、latest versionを使用していることを確認してください。ラッピングは自動的に処理されるため、入力を変更する必要はありません。
ラッピングの詳細については、Wrapping native build commandsを参照してください。
workflows:build-react-native:steps:- activate-ssh-key@4: {}- git-clone@8: {}- activate-build-cache-for-react-native@0: {}# JS dependencies — no wrapping needed.- script@1:title: Install dependenciesinputs:- content: yarn install- script@1:title: Build Androidinputs:- content: bitrise-build-cache react-native run npx react-native run-android --mode=release- script@1:title: Build iOSinputs:- content: bitrise-build-cache react-native run npx react-native run-ios --configuration=Release- deploy-to-bitrise-io@2: {}
セットアップの検証Click to copy link
- 新しい設定でビルドを実行します。アクティベーションステップが正常に完了するはずです。
- Bitriseで Build details ページを開き、Build Cache タブを確認します。ラップされたコマンドがキャッシュ統計とともに一覧表示されます。
- 最初のビルドではキャッシュヒット率が 0% と報告されます。この時点ではキャッシュが空のためで、想定どおりの動作です。
- さらに 1~3 回ビルドを実行してキャッシュを温めます。以降のビルドでは、ヒット率が 0% を超えるはずです。
- ビルドごと、およびビルド全体のキャッシュのパフォーマンスは、Build Cache 一覧ページで確認できます。