since version: 0.0.7

For both Windows and Linux we created functionality to fix exported builds. Unfortunately, we were not able to implement this for macOS, due to a myriad of technical reasons that can only be summarized as "Apple being Apple".

Therefor, the only remaining option is to fix a build manually.

Step 1: mount & extract

When creating a build for macOS, the result is a .dmg file. This .dmg file should be mounted, and the project folder should be extracted, for example: my_project.app.

You can also choose to not extract the folder, but instead mount the .dmg as read/write.

Step 2: remove some libraries

With this extracted folder, we must remove a few libraries from my_project.app/Contents/Frameworks (if present):

• libqtcute_metal.dylib
• libqtcute.dylib
• libgdwebview.macos.arm64.dylib

Step 3: install the webview

Browse to example.app/Contents/MacOS/ and extract the webview there (replace with the correct link):

wget https://godotwebview.com/downloads/gd-webview[...]-macos-arm64-release.zip
unzip gd-webview[...]-macos-arm64-release.zip

So that the webview is installed under: example.app/Contents/MacOS/addons/webview/.

Step 4: reset the signing

As previously mentioned, this addon is not signed. This means that anyone who tries to run a build that includes this addon, it will immediately crash.

First, move into this directory:

cd example.app/Contents/MacOS/

Then 'reset' the signing by running the following bash script.

Step 5

We are now done, it should work/run. You can re-create the .dmg, or simply unmount it if you mounted it read/write.

Note that this build will only work for you, not other people.

To get it to run for everyone, the build needs to be properly signed. This goes beyond the scope of this document.

At this moment, we have no ambition to obtain an Apple developer license, and properly sign our addon. Apple is not a developer friendly platform, and it takes significant time/effort to accomplish anything using this operating system - time we rather spend on Windows, and Linux. However, if you have a bag of money and macOS is crucial to you, drop us an e-mail.