Skip to content

Platforms & Configurations

Daniel Kollmann edited this page Jun 19, 2021 · 2 revisions

This page explains how platforms and configurations work. You basically select a platform and a configuration. The arguments of both are then combined together along with a build action (e.g. clean) and these are the arguments the make file iscalled with.

Platforms

Platforms are defined by the following properties...

Name

This is the name shown in the user interface for this platform.

Enabled

Defines if the platform can be selected or not. So you can disable platforms that you do not want to support.

Available on

Defines if a platform can be built on an operating system. The result of OS.get_name() needs to be in this string.

Arguments

The arguments that will be added when the make file is called. Also all arguments can be used with the syntax %argument%, which will replace it with the value of that argument.

Defines

These are the preprocessor symbols relevant for this platform. This is used when generating projects for IDEs. It does not affect the called make file.

Output Name

The name of the generated output. This must match the actual output generated by the make file.

GDNLIB Key

When updating the .gdnlib file, the generated output name will be saved for this key.

Visual Studio Platform

When generating a Visual Studio project, the platform name must be a toolchain which is installed with Visual Studio.

Configurations

Build configurations are defined by the following properties...

Name

This is the name shown in the user interface for this configuration.

Enabled

Defines if the configuration can be selected or not. So you can disable configurations that you do not want to support.

Arguments

The arguments that will be added when the make file is called. Also all arguments can be used with the syntax %argument%, which will replace it with the value of that argument.

Defines

These are the preprocessor symbols relevant for this platform. This is used when generating projects for IDEs. It does not affect the called make file.

Use Debug Libs

Defines if the debug libraries are used or not. This is used when generating projects for IDEs. It does not affect the called make file.