Developer Setup - MacOS
Introduction
PLEASE NOTE: MacOS support has been dropped due to signing requirements which require a paid Apple developer account. It is still possible to set Semblage up as a developer, and the instructions also still exist to export a release of Semblage. However, the signing issue needs to be straightened out before the app will run. If you are a MacOS developer with a paid developer account who is willing to help out with this, please let us know in the communication channels.
Below are the steps that should produce a working Semblage environment from scratch. This guide will walk developers through that process, and will also explain the export process to get a Semblage package ready for distribution. These steps should be similar (but not exactly the same) on Windows, Mac OS and Linux. Please contribute to this guide if you develop primarily on MacOS and have suggestions on how to make this guide better.
Prerequisites
Open a terminal and run the following commands.
xcode-select --install
brew install python3 openssl zlib
Steps For Working Dev Environment
- Download and install Godot 3.4.5 or a newer 3.4.x version for MacOS.
- Clone the Semblage repo with
git clone --recurse-submodules https://github.com/7BIndustries/Semblage.git
. - Run Godot and open the Semblage project file.
- Go to the AssetLib tab.
- Search for "pythonscript".
- Click on the PythonScript plugin available from touilleMan.
- Click the Download button in the dialog that comes up.
- One the download has completed, click the Install... button.
- Leave everything at the default in the Package Installer dialog and click the Install button.
- You should eventually get a message that the package installed successfully and you can click the OK button.
- Search the
AssetLib
forgut
. - Install the
Gut - Godot Unit Testing
package from bitwes. - Open a terminal and make sure you are in the root
Semblage
directory. - Set
addons/pythonscript/osx-64/bin/python3.8
to be executable:chmod +x addons/pythonscript/osx-64/bin/python3.8
- Run
addons/pythonscript/osx-64/bin/python3.8 -m ensurepip
- Run
addons/pythonscript/x11-64/bin/python3.8 -m pip install --pre git+https://github.com/CadQuery/cadquery.git
- Restart Godot and reopen the Semblage project.
- Semblage should now run and work properly, including exporting the project for distribution.
Exporting
Support for MacOS release packages has been dropped due to problems with not having the Python library signed. If someone is a MacOS user with a paid Appple developer account who wants to take on getting MacOS builds working again, please contact the development team. Below are the steps that should provide a working export package if application signing is possible with your developer account.
This process should be done on a MacOS computer, and has been tested on Mojave 10.14.6. Please note that the first time that you attempt to export the project the export dialog will prompt you to install the templates. Follow the process in the Godot documentation to install the templates.
- From within Godot click
Project -> Export...
- In the dialog that comes up click
Mac OSX (Runnable)
under Presets - Click the
Export Project
button - Set an empty directory named
Semblage
to export the files to in Path: - Make sure that the File: field is set to
Semblage.zip
- Uncheck Export With Debug if it is checked
- Click the Save button
The MacOS export process is partly managed by a custom export plugin, and this can take awhile to run. It may make it seem like the export dialog has stalled, but it has not. Once the Save a File dialog closes you can also close the Export dialog and inspect the directory holding the new export.
Once the export has completed, one clean-up action needs to be completed.
- Expand the Semblage.zip file into the root Semblage export directory.
- Delete the Semblage.zip file.
Testing an Exported Package
To test an exported package, double click Semblage
in the export directory. The Semblage GUI should launch. Next, right click and add a New Component. All of the default settings are fine. Then right click again and add a box (under the 3D group). The default settings for this are fine too. If the box is rendered your release is valid, and can be packaged.
Creating the Release Archive
Add the Semblage directory to an archive named Semblage_MacOS.zip. This archive can then be uploaded to a release.