Building MoonDeploy

This short tutorial is mainly dedicated to Mac OS users - especially if they wish to customize MoonDeploy making it employ the GTK+ user interface (available out-of-the-box for Windows and Linux) in lieu of the terminal interface.

Considering the portable nature of the Go programming language, the required steps are the same for every OS.

Requirements

0. Install the Java Development Kit (required to run Gradle) and:

• set the JAVA_HOME environment variable to its root directory

• add its bin subdirectory to the PATH environment variable

0. Install Gradle and add its bin directory to the PATH environment variable

1. Install Go and:

• set the GOROOT environment variable to its root directory

• add its bin subdirectory to the PATH environment variable

0. Install a suitable C compiler, as well as library support for GTK 3. It is definitely an OS-dependent process, which might require you to consult the documentation of your operating system, compiler and libraries

1. Install the GTK runtime libraries - which, for example, might be provided by GIMP.

Project setup

0. Create a directory that will be your Go path (for example, GoPath in your home directory)

1. Assign such dir to the GOPATH environment variable

2. Within GOPATH, create the src/github.com/giancosta86/moondeploy directory subtree

3. Open a terminal within the moondeploy directory

4. Run:

git clone "https://github.com/giancosta86/moondeploy.git"

GUI customization step (for Mac OS users)

On Mac OS, you can replace the Bash user interface with the GTK+ user interface:

0. In the project directory, open the file named moonclient/verbs/startGUI_darwin.go

1. Replace

"github.com/giancosta86/moondeploy/moonclient/gui/bash"

with

"github.com/giancosta86/moondeploy/moonclient/gui/gtk"

0. Replace

return bash.StartGUI(launcher, bootDescriptorPath)

with

return gtk.StartGUI(launcher, bootDescriptorPath)

Build steps

0. Run:

gradle build

The most critical part will be to build the C libraries - please check the error messages and consult the documentation of your compiler suite

0. If the process completes successfully, you will find a zip file within the build subdirectory: it is the archive containing the binary files for your operating system!

1. Extract the zip file to a directory of your choice, which you should add to the PATH environment variable

2. Be sure to add the resource files (in particular, .png images) from the PROJECT_DIR/moonclient/resources/ directory

Now, to run an application packaged with MoonDeploy you should just run:

moondeploy "any .moondeploy descriptor"