This action is intended to switch between pre-installed versions of Xcode for macOS images in GitHub Actions.

The list of all available versions can be found in runner-images repository.

Notes:

• latest-stable points to the latest stable version of Xcode
• latest includes beta releases that GitHub actions has installed
• SemVer examples: 16, 16.4, 26.3, ^16.2.0 (find more examples in SemVer cheatsheet)
• -beta suffix after SemVer will only select among beta releases that GitHub actions has installed
• If sets a specific version, wraps it to single quotes in YAML like '12.0' to pass it as string because GitHub trimmes trailing .0 from numbers

Set the latest stable Xcode version:

jobs:
  build:
    runs-on: macos-latest
    steps:
    - uses: maxim-lobanov/setup-xcode@v1
      with:
        xcode-version: latest-stable

Set the latest Xcode version including beta releases:

jobs:
  build:
    runs-on: macos-latest
    steps:
    - uses: maxim-lobanov/setup-xcode@v1
      with:
        xcode-version: latest

Set the specific stable version of Xcode:

jobs:
  build:
    runs-on: macos-15
    steps:
    - uses: maxim-lobanov/setup-xcode@v1
      with:
        xcode-version: '16.4'

Set a specific Xcode version on macos-26:

jobs:
  build:
    runs-on: macos-26
    steps:
    - uses: maxim-lobanov/setup-xcode@v1
      with:
        xcode-version: '26.3'

The scripts and documentation in this project are released under the MIT License