Difference between revisions of "Build tool"
From MSX Game Library
(→Build Tool) |
(→Path) |
||
| Line 32: | Line 32: | ||
{{PARAM|ToolsDir|Tools directory (string)|`${RootDir}tools/`}} | {{PARAM|ToolsDir|Tools directory (string)|`${RootDir}tools/`}} | ||
| + | |||
| + | === Tools === | ||
| + | |||
| + | {{PARAM|Compiler|Path to the C compile program (string)|`${ToolsDir}sdcc\bin\sdcc`}} | ||
| + | |||
| + | {{PARAM|Assembler|Path to the assembler program (string)|`${ToolsDir}sdcc\bin\sdasz80`}} | ||
| + | |||
| + | {{PARAM|Linker|Path to the linker program (string)|`${ToolsDir}sdcc\bin\sdcc`}} | ||
| + | |||
| + | {{PARAM|MakeLib|Path to the program to generate lib file (string)|`${ToolsDir}sdcc\bin\sdar`;}} | ||
| + | |||
| + | {{PARAM|Hex2Bin|Path to IHX to binary convertor (string)|`${ToolsDir}MSXtk\bin\MSXhex`}} | ||
| + | |||
| + | {{PARAM|MSXDOS|Path to the MSX-DOS files (string)|`${ToolsDir}build\MSXDOS`}} | ||
| + | |||
| + | {{PARAM|DskTool|Path to the tool to generate DSK file (string)|`${ToolsDir}build\DskTool\dsktool`}} | ||
| + | |||
| + | {{PARAM|Emulator|Path to the emulator to launch the project (string)|}} | ||
| + | |||
| + | {{PARAM|Debugger|Path to the debugger to test the project (string)|}} | ||
=== Compilation === | === Compilation === | ||
Revision as of 00:53, 23 December 2022
Configuration
The Build tool configuration's parameters are defined in the engine (engine/script/js/setup_global.js) and can be modified by the user using at two levels:
- The default configuration (projects/default_config.js), commun for all the projects.
- The project configuration (projects/myProject/project_config.js), specific for a given project.
The value of the parameters redefined in a higher level replaces that of a lower level. The order of priority is: Project > Default > Engine.
Parameters
Build Tool
Verbose: Activate verbose mode and get more build information (boolean) [type: false | default: {{{4}}}]
LogStdout: Output build information to the standard console (boolean) [type: true | default: {{{4}}}]
LogFile: Output build information to a log file (boolean) [type: false | default: {{{4}}}]
LogFileName: Name of the log file (string) [type: "log_YYYYMMDD_HHMMSS.txt" | default: {{{4}}}]
Path
ProjDir: Project directory (string) [type: | default: {{{4}}}]
OutDir: Intermediate files directory (string) [type: `${ProjDir}out/` | default: {{{4}}}]
RootDir: MSXgl root directory (string) [type: | default: {{{4}}}]
LibDir: Library directory (string) [type: `${RootDir}engine/` | default: {{{4}}}]
ToolsDir: Tools directory (string) [type: `${RootDir}tools/` | default: {{{4}}}]
Tools
Compiler: Path to the C compile program (string) [type: `${ToolsDir}sdcc\bin\sdcc` | default: {{{4}}}]
Assembler: Path to the assembler program (string) [type: `${ToolsDir}sdcc\bin\sdasz80` | default: {{{4}}}]
Linker: Path to the linker program (string) [type: `${ToolsDir}sdcc\bin\sdcc` | default: {{{4}}}]
MakeLib: Path to the program to generate lib file (string) [type: `${ToolsDir}sdcc\bin\sdar`; | default: {{{4}}}]
Hex2Bin: Path to IHX to binary convertor (string) [type: `${ToolsDir}MSXtk\bin\MSXhex` | default: {{{4}}}]
MSXDOS: Path to the MSX-DOS files (string) [type: `${ToolsDir}build\MSXDOS` | default: {{{4}}}]
DskTool: Path to the tool to generate DSK file (string) [type: `${ToolsDir}build\DskTool\dsktool` | default: {{{4}}}]
Emulator: Path to the emulator to launch the project (string) [type: | default: {{{4}}}]
Debugger: Path to the debugger to test the project (string) [type: | default: {{{4}}}]
Compilation
- InstallRAMISR: Set RAM in slot 0 and install ISR there (false, true)
- AppSignature: Add application signature to binary data (false, true)