Skip to content

Commit 3b7fa3f

Browse files
removed outdated note on .app not being supported, and minor improvements to macOS export notes
1 parent e44bbb6 commit 3b7fa3f

File tree

2 files changed

+10
-6
lines changed

2 files changed

+10
-6
lines changed

tutorials/export/exporting_for_macos.rst

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,18 @@ Exporting for macOS
1010
read :ref:`doc_compiling_for_macos`.
1111

1212
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.
13-
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).
13+
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).
1414
`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>`__.
1515

1616
.. warning::
17-
Due to file system limitations, raw ``.app`` bundles exported from Windows lack ``executable`` flag and won't run on macOS.
18-
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.
19-
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.
17+
Due to file system limitations, ``.app`` bundles exported from Windows lack the
18+
``executable`` flag and won't run on macOS. Projects exported as ``.zip`` are not
19+
affected by this issue. To run ``.app`` bundles exported from Windows on macOS,
20+
transfer the ``.app`` to a device running macOS or Linux and use the
21+
``chmod +x {executable_name}`` terminal command to add the ``executable`` permission.
22+
The main executable located in the ``Contents/MacOS/`` subfolder, as well
23+
as optional helper executables in the ``Contents/Helpers/`` subfolder, should have
24+
the ``executable`` permission for the ``.app`` bundle to be valid.
2025

2126
Requirements
2227
------------

tutorials/export/exporting_projects.rst

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -193,8 +193,7 @@ The output path is *relative to the project path* or *absolute*;
193193
The output file extension should match the one used by the Godot export process:
194194

195195
- Windows: ``.exe``
196-
- macOS: ``.zip`` (from all platforms) or ``.dmg`` (only when exporting *from* macOS).
197-
``.app`` is not supported directly, although the generated ZIP archive contains an ``.app`` bundle.
196+
- macOS: ``.app`` or ``.zip`` (or ``.dmg`` when exporting *from* macOS)
198197
- Linux: Any extension (including none). ``.x86_64`` is typically used for 64-bit x86 binaries.
199198
- HTML5: ``.zip``
200199
- Android: ``.apk``

0 commit comments

Comments
 (0)