How to compile a Godot project to iOS without a Mac

If you don't have a Mac, there's an easy way to compile Godot projects (or most XCode projects for that matter) to iOS.

Date: July 22, 2024

Modified November 12, 2024

Author: mak448a

Requirements

Step 1: Setup GitHub repository

  1. First, create a GitHub repository. Set it to private if you don't want anyone downloading your game from here.
  2. Now download it to your computer using git: git pull (github.com/user/yourrepourl)

Step 2: Create local GitHub repository

  1. Download my starter repository here. Next, copy the contents of that folder to your local repository.
  2. Open your local repository in your file manager and open to .github/workflows/build.yml. You may have to show hidden files if you're on Mac or Linux. Replace all occurences of "Example-Project" with your project name.

Step 3: Export and upload

  1. Go to Project>Export and press Add...>iOS.
  2. Fill "Bundle Identifier" in as io.github.yourusername.yourgame and fill App Store Team ID in as 1234.
  3. Click on "Export Project" and save it to your local repository that you downloaded in step 2.
  4. Run git commit -m "Upload" and git push.
  5. If you get an error saying that you have exceeded GitHub's upload limit, follow the instructions here to upload to Dropbox instead.

Step 4: Download your build

  1. Visit your repository URL on GitHub and go to the Actions tab.
  2. Click on the topmost entry.
  3. Check the colored indicator. If it's still yellow, wait until it's green then refresh the page. Now, scroll to the bottom and click the download button.

Questions? Comments?

If you have any questions, you can either comment below and tag me with @mak448a or email me at by clicking on the mail icon on my homepage. Thanks for reading my blog!