How to use gt-installer
The build process of the Glamorous Toolkit can be split into two phases:
setup. Each of these steps has multiple parameters for a fine grained parametrisation. A good control over the process is nice, however it may become cumbersome when it comes to the basic use-cases. Therefore
gt-installer also provides extra helper commands that combine the
setup to make the installation process easier.
Glamorous Toolkit is built on top of Pharoand an image which is used as the base is called a
seed. There are multiple types of seeds:
zip. When building Glamorous Toolkit on tope of a file seed, the code will be loaded in the specified image without copying it.
Version to load
gt-installer allows developers to specify which version of the Glamorous Toolkit to load. It can be specified by providing an optional
--version argument. The
--version accepts the following values:
bleeding-edge (default) to load the code from the truck
latest-release to load the latest released version
vX.Y.Z to load a specific symbolic released version
Creates a release build of Glamorous Toolkit with
GtWorld openDefault and sets up the image which can be deployed. This is intended to be used by the Continuous Integration server.
Release builds of the Glamorous Toolkit are designed to be portable and deployable. It means that the original source code from which it was built is detached and may not be distributed. However, there are numerous files such as fonts or documentation that must be deployed together with the image to ensure the functioning environment. Such files are automatically copied into the
gt-extra folder during the
setup phase. The
gt-extra folder should be placed in the same folder as the
How to load the latest released version of GT
./gt-installer release-build --version latest-release
How to load the a specific version of GT
./gt-installer release-build --version v0.8.870
How to load a release distribution of GT into an existing image
./gt-installer release-build --image-file path/to/my.image
How to load a release distribution of GT into an image from a url
./gt-installer release-build --image-url "https://example/image.zp"
How to load a release distribution of GT without opening a GtWorld
./gt-installer release-build --no-gt-world
How to see all arguments
./gt-installer release-build --help