Remote Build - iOS
ActionsThis GitHub Action enables remote building of iOS applications using Rock. It supports both simulator and device builds, with automatic artifact caching and code signing capabilities.
- Build iOS apps for simulator or device
- Automatic artifact caching to speed up builds
- Code signing support for device builds
- Re-signing capability for PR builds
- Native fingerprint-based caching
- Configurable build parameters
name: iOS Build
on:
push:
branches: [main]
pull_request:
branches: ['**']
jobs:
build:
runs-on: macos-latest
steps:
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
- name: Build iOS
uses: callstackincubator/ios@v3 # replace with latest commit hash
with:
destination: 'simulator' # or 'device'
scheme: 'YourScheme'
configuration: 'Debug'
github-token: ${{ secrets.GITHUB_TOKEN }}
# For device builds, add these:
# certificate-base64: ${{ secrets.CERTIFICATE_BASE64 }}
# certificate-password: ${{ secrets.CERTIFICATE_PASSWORD }}
# provisioning-profile-base64: ${{ secrets.PROVISIONING_PROFILE_BASE64 }}
# provisioning-profile-name: 'YourProfileName'
# keychain-password: ${{ secrets.KEYCHAIN_PASSWORD }}
# re-sign: true
# ad-hoc: true| Input | Description | Required | Default |
|---|---|---|---|
github-token |
GitHub Token | Yes | - |
working-directory |
Working directory for the build command | No | . |
destination |
Build destination: "simulator" or "device" | Yes | simulator |
scheme |
Xcode scheme | Yes | - |
configuration |
Xcode configuration | Yes | - |
re-sign |
Re-sign the app bundle with new JS bundle | No | false |
ad-hoc |
Upload the IPA for ad-hoc distribution to easily install on provisioned devices | No | false |
certificate-base64 |
Base64 encoded P12 file for device builds | No | - |
certificate-password |
Password for the P12 file | No | - |
provisioning-profile-base64 |
Base64 encoded provisioning profile | No | - |
provisioning-profile-name |
Name of the provisioning profile | No | - |
keychain-password |
Password for temporary keychain | No | - |
rock-build-extra-params |
Extra parameters for rock build:ios | No | - |
comment-bot |
Whether to comment PR with build link | No | true |
| Output | Description |
|---|---|
artifact-url |
URL of the build artifact |
artifact-id |
ID of the build artifact |
- macOS runner
- Rock CLI installed in your project
- For device builds:
- Valid Apple Developer certificate
- Valid provisioning profile
- Proper code signing setup
MIT
Remote Build - iOS is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.
Remote Build - iOS is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.