From a0501c87382eb4afc82331f0e6db9e3f2409c1b4 Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Sat, 27 Sep 2025 00:54:59 +0200 Subject: [PATCH] Document exporting/compiling for the iOS simulator not currently being supported Once the issue is resolved, it could support Compatibility but not Forward+/Mobile due to these renderers requiring a feature the iOS simulator doesn't support (image cube arrays). --- .../development/compiling/compiling_for_ios.rst | 8 ++++++++ tutorials/export/exporting_for_ios.rst | 9 +++++++++ 2 files changed, 17 insertions(+) diff --git a/engine_details/development/compiling/compiling_for_ios.rst b/engine_details/development/compiling/compiling_for_ios.rst index 1ad0d877f28..72c64270d6a 100644 --- a/engine_details/development/compiling/compiling_for_ios.rst +++ b/engine_details/development/compiling/compiling_for_ios.rst @@ -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 `__. + + 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 --- diff --git a/tutorials/export/exporting_for_ios.rst b/tutorials/export/exporting_for_ios.rst index 45fbbaca83e..604e454a6e2 100644 --- a/tutorials/export/exporting_for_ios.rst +++ b/tutorials/export/exporting_for_ios.rst @@ -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 `__. + + 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.