https://github.com/petrgon/godot-unsigned-ios-build
This repository provides a ready-to-use GitHub Action script for building a Godot project for iOS. It enables you to create an iOS build without requiring access to a Mac.
https://github.com/petrgon/godot-unsigned-ios-build
automation build github-actions godot godot-4 ios ipa sideloading-ipas unsigned-ipa xcodebuild
Last synced: 2 months ago
JSON representation
This repository provides a ready-to-use GitHub Action script for building a Godot project for iOS. It enables you to create an iOS build without requiring access to a Mac.
- Host: GitHub
- URL: https://github.com/petrgon/godot-unsigned-ios-build
- Owner: petrgon
- License: unlicense
- Created: 2025-07-07T17:21:29.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-07T18:05:22.000Z (12 months ago)
- Last Synced: 2025-07-07T18:48:20.654Z (12 months ago)
- Topics: automation, build, github-actions, godot, godot-4, ios, ipa, sideloading-ipas, unsigned-ipa, xcodebuild
- Homepage:
- Size: 12.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Godot iOS Build (Unsigned IPA) – GitHub Action Script
This repository provides a ready-to-use GitHub Action script for building a Godot project for iOS. It enables you to create an iOS build without requiring access to a Mac.
**The script:** [build-ios-unsigned.yml](https://github.com/petrgon/godot-unsigned-ios-build/blob/main/build-ios-unsigned.yml), copy it into `/.github/workflows/` in your repository.
Special thanks to [mak448a](https://github.com/mak448a) for their work, which served as the foundation for this script. See their [repository](https://github.com/mak448a/build-ios) for reference.
> [!WARNING]
> Some one-time configuration is required. Please refer to the comments within each step of the YAML file for setup instructions.
> [!WARNING]
> The output of this workflow is not intended for distribution. It is meant for local development only. To run the unsigned IPA on your device, you will need to use sideloading methods.
## How to Sideload an Unsigned IPA
There are several methods to sideload an unsigned IPA onto your iOS device. Most of them typically involve the following steps:
1. Have an Apple ID and iTunes installed on your PC or Mac to retrieve your device’s UDID.
1. Install a sideloading server on your PC or Mac and connect it with your Apple account.
1. Download a third-party app store and mark it as trusted.
1. Install the IPA file using the third-party app store.
1. Enable Developer Mode on your iOS device.
1. Add your Apple account as a trusted developer on your iOS device.
> [!WARNING]
> The sideloaded app will remain available on your device for 7 days. After that period, you will need to renew its authorization using the sideloading server.
For a step-by-step guide, I recommend referring to the instructions provided by the VCMI project: 👉 [VCMI iOS Installation Guide](https://vcmi.eu/players/Installation_iOS/)