Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maxim-lobanov/setup-xcode
Set up your GitHub Actions workflow with a specific version of Xcode
https://github.com/maxim-lobanov/setup-xcode
Last synced: 2 days ago
JSON representation
Set up your GitHub Actions workflow with a specific version of Xcode
- Host: GitHub
- URL: https://github.com/maxim-lobanov/setup-xcode
- Owner: maxim-lobanov
- License: mit
- Created: 2020-04-26T15:40:53.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-25T16:11:20.000Z (7 months ago)
- Last Synced: 2025-01-06T23:03:50.413Z (8 days ago)
- Language: TypeScript
- Size: 418 KB
- Stars: 291
- Watchers: 3
- Forks: 28
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-actions - Setup Xcode - Switch between pre-installed versions of Xcode for macOS images. (Community Resources / Utility)
- fucking-awesome-actions - Setup Xcode - Switch between pre-installed versions of Xcode for macOS images. (Community Resources / Utility)
- awesome-workflows - Setup Xcode - Switch between pre-installed versions of Xcode for macOS images. (Community Resources / Utility)
README
# setup-xcode
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](https://github.com/actions/runner-images/blob/master/images/macos/macos-13-Readme.md#xcode) repository.
# Available parameters
| Argument | Description | Format |
|-------------------------|--------------------------|--------------------|
| `xcode-version` | Specify the Xcode version to use | - `latest` or
- `latest-stable` or
- [SemVer](https://semver.org/) string or
- `-beta` |
**Notes:**
- `latest-stable` points to the latest stable version of Xcode
- `latest` *includes* beta releases that GitHub actions has installed
- SemVer examples: `14`, `14.1`, `14.3.1`, `^14.3.0` (find more examples in [SemVer cheatsheet](https://devhints.io/semver))
- `-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
# Usage
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-13
steps:
- uses: maxim-lobanov/setup-xcode@v1
with:
xcode-version: '14.3.1'
```
Set the specific beta version of Xcode:
```
jobs:
build:
runs-on: macos-13
steps:
- uses: maxim-lobanov/setup-xcode@v1
with:
xcode-version: '15.0-beta'
```
# License
The scripts and documentation in this project are released under the [MIT License](LICENSE)