Builds a statically linked library.
Library( alias ) ; (optional) Alias
{
; options for compilation
.Compiler ; Compiler to use
.CompilerOptions ; Options for compiler
.CompilerOutputPath ; Path to store intermediate objects
; Options for librarian
.Librarian ; Librarian to collect intermediate objects
.LibrarianOptions ; Options for librarian
.LibrarianOutput ; Output path for lib file
; One or more input type must be specified
.CompilerInputPath ; (optional) Path to find files in
.CompilerInputPattern ; (optional) Pattern to use when finding files (default *.cpp)
.CompilerInputPathRecurse ; (optional) Recurse into dirs when finding files (default true)
.CompilerInputExcludePath ; (optional) Path to exclude from traversal
.CompilerInputFiles ; (optional) Explicit array of files to build
.CompilerInputUnity ; (optional) Unity to build
; (optional) Properties to control precompiled header use
.PCHInputFile ; (optional) Precompiled header (.cpp) file to compile
.PCHOutputFile ; (optional) Precompiled header compilation output
.PCHOptions ; (optional) Options for compiler for precompiled header
}
Build-Time Substitutions
- CompilerOptions
- %1 - Input file for each invocation of the compiler as determined by the various Input parameters.
- %2 - Output name of object being compiled, as specified by 'CompilerOutputPath' and the name of discovered objects
depending on the Compiler input options (extension is also replace with '.obj').
- LibrarianOptions
- %1 - List of objects to link.
- %2 - Output library as specified by 'LibrarianOutput'.
- PCHOptions
- %1 - Input file for used to generate the PCH (PCHInputFile).
- %2 - Output name of PCH file to generate (PCHOutputFile).
- %3 - (MSVC Only) Object file associated with PCH file, which will be used in linking. (PCHOutputFile + '.obj').