Difference between revisions of "Batch to JS conversion guide"

From MSX Game Library

Line 13: Line 13:
 
#** Replace any '<tt>::</tt>' by '<tt>//</tt>'.
 
#** Replace any '<tt>::</tt>' by '<tt>//</tt>'.
 
#** Replace any '<tt>REM</tt>' by '<tt>//</tt>'.
 
#** Replace any '<tt>REM</tt>' by '<tt>//</tt>'.
#* Remove '<tt>@echo off</tt>' and '<tt>call ..\default_config.cmd %0</tt>'.
+
#* Remove '<tt>@echo off</tt>', '<tt>call ..\default_config.cmd %0</tt>' and final '<tt>call %LibDir%\script\build.cmd</tt>'.
#* Remove all '<tt>set </tt>' before the parameter name.
+
#* Remove all the '<tt>set </tt>' before the parameter name.

Revision as of 18:12, 22 December 2022

Historically, MSXGL was designed on Windows PC, for users of this platform. The Build tool was therefore written in Batch language (.bat).

To open the library to users of other platforms (Linux and macOS) and overcome the limitations of the Batch language, the Build tool has been entirely rewritten in Java Script and executed via Node.js. Everything necessary for the execution of these new scripts being packaged with MSXgl on Windows, the user has no other software to install. For Linux, SDCC and Node.js must be installed separately.

This guide is intended for users who have already created an MSXgl project and who would like to convert their project configuration to benefit from the new version of the Build tool (which I strongly recommend).

Convert Batch project to JS

  1. Rename your build.bat to project_config.js (You can duplicate the file if you want to keep the batch file as a backup)
  2. Open project_config.js an start the Batch to JS converion:
    • Convert comment:
      • Replace any '::' by '//'.
      • Replace any 'REM' by '//'.
    • Remove '@echo off', 'call ..\default_config.cmd %0' and final 'call %LibDir%\script\build.cmd'.
    • Remove all the 'set ' before the parameter name.