Distributing macOS builds

macOS might just be the ideal platform to distribute third-party, proprietary apps.

Just push your .app bundle withbutler.

That's it.

If you need anapp manifest, put your .app and the manifest in a folder, and pushthat one with butler.

If you reallyreally want to do something else, read theCompatibility policy page.

...but I don't have an app bundle

App bundles are directories with a standardized structure and some metadata in anInfo.plist file.

Here's agood stackoverflow thread on how they're created. Good luck!

Please don't push naked macOS binaries.

Support for them is disappearing a little more every macOS release.

Symbolic links and permissions

App bundles typically have symbolic links (for frameworks) and need some file permissions to be set properly.

We've taken several measures to ensure this works properly:

• At upload time
  • butler handles symlinks, and fixes file permissions if they're wrong
• At launch time
  • the itch.io app fixes permissions if they're wrong.

If you don't use butler and upload an archive with wrong permissions, when players download and play your game without using the itch.io app, they'll encouterError -10810.

Gatekeeper & other security measures

For players that arenotusing the itch.io app, you might get reports of your app being "Damaged and can't be opened" and that it should "be moved to the trash".

Player who do use the itch.io app do not encounter these issues, so you may want to encourage them to use it.