|
@@ -10,13 +10,18 @@ Exporting for macOS
|
|
|
read :ref:`doc_compiling_for_macos`.
|
|
|
|
|
|
macOS apps exported with the official export templates are exported as a single "Universal 2" binary ``.app`` bundle, a folder with a specific structure which stores the executable, libraries and all the project files.
|
|
|
-This bundle can be exported as is, packed in a ZIP archive or DMG disk image (only supported when exporting from a computer running macOS).
|
|
|
+This bundle can be exported as is, packed in a ZIP archive, or packed in a DMG disk image (only supported when exporting from macOS).
|
|
|
`Universal binaries for macOS support both Intel x86_64 and ARM64 (Apple Silicon) architectures <https://developer.apple.com/documentation/apple-silicon/building-a-universal-macos-binary>`__.
|
|
|
|
|
|
.. warning::
|
|
|
- Due to file system limitations, raw ``.app`` bundles exported from Windows lack ``executable`` flag and won't run on macOS.
|
|
|
- To fix it, use the ``chmod +x {executable_name}`` command after transferring the exported ``.app`` to macOS or Linux. Projects exported as ``.zip`` aren't affected by this issue.
|
|
|
- The main executable located in the ``Contents/MacOS/`` subfolder, as well as optional helper executables in the ``Contents/Helpers/`` subfolder, should have ``executable`` permission for the ``.app`` bundle to be valid.
|
|
|
+ Due to file system limitations, ``.app`` bundles exported from Windows lack the
|
|
|
+ ``executable`` flag and won't run on macOS. Projects exported as ``.zip`` are not
|
|
|
+ affected by this issue. To run ``.app`` bundles exported from Windows on macOS,
|
|
|
+ transfer the ``.app`` to a device running macOS or Linux and use the
|
|
|
+ ``chmod +x {executable_name}`` terminal command to add the ``executable`` permission.
|
|
|
+ The main executable located in the ``Contents/MacOS/`` subfolder, as well
|
|
|
+ as optional helper executables in the ``Contents/Helpers/`` subfolder, should have
|
|
|
+ the ``executable`` permission for the ``.app`` bundle to be valid.
|
|
|
|
|
|
Requirements
|
|
|
------------
|