Developer Setup - Linux

Introduction

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 Linux and have suggestions on how to make this guide better.

Steps For Working Dev Environment

  • Download and install Godot 3.4.5 or a newer 3.4.x version for 64-bit Linux.
  • Clone the Semblage repo with git clone --recurse-submodules https://github.com/7BIndustries/Semblage.git.
  • Run Godot and import 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 for gut.
  • 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/x11-64/bin/python3.8 to be executable: chmod +x addons/pythonscript/x11-64/bin/python3.8
  • Run addons/pythonscript/x11-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

There is a GitHub Action that will build this package, but the instructions below cover doing it on your local computer. This process should be done on a Linux computer, and has been tested on Ubuntu 18.04. 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 Linux/X11 (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.x86_64
  • Uncheck Export With Debug if it is checked
  • Click the Save button

The Linux 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, two files within the export directory must be set to be executable (if they are not already). These files are Semblage and Semblage.x86_64. You can set them to be executable in the following way.

  • chmod +x /path/to/Semblage/Semblage
  • chmod +x /path/to/Semblage/Semblage.x86_64

Testing an Exported Package

To test an exported package, double click Semblage in the export directory. The Semblage GUI should launch. In some Linux desktop environments you must configure the file manager to run text files that have been set as executable. Next, right click in the Semblage 3D view 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_Linux_x86_64.tar.xz. This archive can then be uploaded to a release.