Skip to content

Commit 13f05b1

Browse files
committed
Add note about limitations of macOS export from Windows.
1 parent bf4c8bd commit 13f05b1

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

tutorials/export/exporting_for_macos.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,11 @@ macOS apps exported with the official export templates are exported as a single
1313
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).
1414
`Universal binaries for macOS support both Intel x86_64 and ARM64 (Apple silicon, i.e. M1) architectures <https://developer.apple.com/documentation/apple-silicon/building-a-universal-macos-binary>`__.
1515

16+
.. 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.
20+
1621
Requirements
1722
------------
1823

0 commit comments

Comments
 (0)