Skip to content

Document exporting/compiling for the iOS simulator not currently being supported #11324

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 26, 2025
+17 −0
Merged

Document exporting/compiling for the iOS simulator not currently being supported #11324

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions engine_details/development/compiling/compiling_for_ios.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,14 @@ The MoltenVK static ``.xcframework`` folder must also be placed in the
``ios_xcode`` folder once it has been created. MoltenVK is always statically
linked on iOS; there is no dynamic linking option available, unlike macOS.

.. warning::

Compiling for the iOS simulator is currently not supported as per
`GH-102149 <https://github.com/godotengine/godot/issues/102149>`__.

Apple Silicon Macs can run iOS apps natively, so you can run exported iOS projects
directly on an Apple Silicon Mac without needing the iOS simulator.

Run
---

Expand Down
9 changes: 9 additions & 0 deletions tutorials/export/exporting_for_ios.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,15 @@ When the export completes, the output folder should look like this:

.. image:: img/ios_export_output.webp


.. warning::

Exporting for the iOS simulator is currently not supported as per
`GH-102149 <https://github.com/godotengine/godot/issues/102149>`__.

Apple Silicon Macs can run iOS apps natively, so you can run exported iOS projects
directly on an Apple Silicon Mac without needing the iOS simulator.

Opening **exported_xcode_project_name.xcodeproj** lets you build and deploy
like any other iOS app.

Expand Down
Loading