Installation

Installing the module

The simplest way to install this module is to follow the steps below:

• Create a 'modules' directory in your main premake5.lua location.
• Clone this repository in the 'modules' directory under the 'fastbuild' location. cd modules && git clone https://github.com/Dandielo/premake5-fastbuild.git fastbuild
• Add in your main premake5.lua file the following line require "fastbuild"

Prerequisites

As because it's too much work create a compiler discovery function for each fastbuild supported compiler this module requires you to provide all available compilers. Such a compiler should be defined in a separate file. More can be found here.

Registering a compiler can be done with the following function in premake's global scope.

fbcompilers { 
    { 
        name = "msc64", -- Name for logging purposes 
        system = "windows", -- The compilers target machine (eg. windows, linux, etc).
        architecture = "x86_64", -- The compilers target architecture (eg. x86, x64)
        toolset = "v141", -- The compiler toolset to be used (needed on 'windows' systems)
        path = ".fbuild/compilers/msc64.bff" -- The file with the compiler struct definition
    }, -- More available compilers...
}

After that is done the given compiler file should define a struct which is named in the following way platform_{system}_{architecture}_{toolset}, where the {system}, {architecture} and {toolset} values are equal to values provided in the fbcompilers function.