Build Godot iOS projects on Windows
Export from Godot as usual, then build it on Windows like any other iOS project.
The iOS project Godot exports can be built on Windows, installed on your iPhone and debugged at the native layer. Export from Godot as usual and use the export folder like any Xcode project. Your Godot project settings stay as they are.
Steps
Develop in Godot and export an Xcode project
Develop your project in Godot as usual. Download the export templates from Editor > Manage Export Templates, add an iOS preset in Project > Export, fill in App Store Team ID and Bundle Identifier, and export to an empty folder outside the Godot project with a file name such as MyGame.ipa. On Windows, Godot writes the Xcode project MyGame.xcodeproj instead of an .ipa. Then open that folder in VS Code with File > Open Folder….
Run doctor
Doctor checks your build environment and fixes anything missing.
Use either of these
-
VS Code extension
In the title bar of the KXBuild view, open the ··· menu and run Doctor (fix environment).
-
Command line
> kxbuild doctor .\MyGame.xcodeproj
Write code
Edit GDScript and scenes in Godot as usual, then export again to the same folder. Native code in the export folder gets completion and go-to-definition in VS Code.
Debug
Connect your iPhone over USB, select it in the KXBuild view and press F5. Native code gets breakpoints in VS Code, and GDScript uses Godot's own debugger. The two don't get in each other's way.
Release
Build with the Release configuration to get an .ipa in the export folder. To upload it to App Store Connect, see Publish to the App Store.
Use either of these
-
VS Code extension
Switch the configuration to Release in the Build configuration node of the KXBuild view, then run KXBuild: Build from the Command Palette.
-
Command line
> kxbuild build .\MyGame.xcodeproj -c Release
Next steps
Build and configure
Debug versus Release, choosing a scheme, target and configuration, overriding build settings, where build products go, when you get an .ipa and when Swift package dependencies resolve.
Release and App Store submission
Build Release with a Distribution certificate to get an .ipa, upload it to App Store Connect with Transporter or Appuploader, then go through TestFlight and App Review. Ad Hoc and enterprise distribution work the same way.
Don't see your framework?
kxbuild is a general-purpose build toolchain, so if your framework produces an Xcode project, KXBuild can build it. The list above covers common cases only. Tell us about your setup.