Skip to main content

Configuring the Build Cache for Xcode in the Bitrise CI environment

Abstract

You need the Bitrise Build Cache for Xcode Step to activate the Build Cache for your Xcode project. After the Step executes, Xcode tasks will automatically read from the build cache and push new entries, too.

You need the Bitrise Build Cache for Xcode Step to activate the Build Cache for your Xcode project. After the Step executes, Xcode tasks will automatically read from the build cache and push new entries, too.

Workflow Editor

Configuration YAML

  1. Make sure your build runs on a stack with Xcode 26 or higher version installed: Setting the stack for your builds.

  2. Log in to Bitrise and select Bitrise CI on the left, then select your project.

  3. Click the Workflows button on the main page.

    opening-workflow-editor.png

  4. Add the Build Cache for Xcode Step to your Workflow.

    The Step should be before any Step that executes Xcode tasks. For example, fastlane or Xcode Archive & Export for iOS.

  5. Optionally, you can disable pushing new cache entries: set the Push new cache entries input to false.

    In read-only mode, your build only reads from the cache but doesn't update it.

  6. Click Save changes.

Make sure your build runs on a stack with Xcode 26 or higher version installed: Setting the stack for your builds.

  • Add the activate-build-cache-for-xcode Step to your Workflow.

    The Step should be before any Step that executes Xcode tasks. For example, fastlane or xcode-archive.

    your-workflow:
  meta:
    bitrise.io:
      stack: osx-xcode-26.0.x-edge
  steps:
    - git-clone: {}
    - activate-build-cache-for-xcode: {}
In this section: