Difference between revisions of "Build Configurations"

From VSI OpenVMS Wiki
Jump to: navigation, search
Line 2: Line 2:
 
== Named build configurations ==
 
== Named build configurations ==
  
 +
The build process depends on this configuration. Each label describes one way of building.
 +
 +
<pre>
 
     "builds": {
 
     "builds": {
 
         "configurations": [
 
         "configurations": [
Line 30: Line 33:
 
         ]
 
         ]
 
     }
 
     }
 +
</pre>
  
 
* '''label''' - unique label, name of build configuration. Also this value is used as output folder.
 
* '''label''' - unique label, name of build configuration. Also this value is used as output folder.
Line 42: Line 46:
 
If the user defined command is COM file, it is executed like "@<COM file> '''parameter'''".<br>
 
If the user defined command is COM file, it is executed like "@<COM file> '''parameter'''".<br>
  
  '''Note:''' it is recommended that user-defined build procedure creates resulting files in <project root>/<output folder>/<build label> directory. So does default procedure.
+
  '''Note:''' it is recommended that user-defined build procedure creates resulting files in '''<project root>/<output folder>/<build label>''' directory. So does default procedure.
  
 
In the '''CLEAN''' operation '''parameter''' will be just "CLEAN" string.<br>
 
In the '''CLEAN''' operation '''parameter''' will be just "CLEAN" string.<br>

Revision as of 04:06, 8 August 2019

Named build configurations

The build process depends on this configuration. Each label describes one way of building.

    "builds": {
        "configurations": [
            {
                "label": "DEBUG",
                "description": "DEBUG",
                "command": "",
                "parameter": "DEBUG" 
            },
            {
                "label": "RELEASE",
                "description": "RELEASE",
                "command": "",
                "parameter": "RELEASE" 
            },
            {
                "label": "myOwnRelease",
                "description": "My own build release",
                "command": "executable.mms",
                "parameter": "" 
            },
            {
                "label": "myOwnDebug",
                "description": "My own build debug",
                "command": "build.com",
                "parameter": "DEBUG" 
            }
        ]
    }
  • label - unique label, name of build configuration. Also this value is used as output folder.
  • description - description
  • command - command to build, clean project
  • parameter - parameter to pass into command

In case of command is empty the default auto-created MMS file is used to build project. Parameter is used to distinguish DEBUG and RELEASE.

If the user defined command is MMS file, it is processed via command "MMS/EXTENDED_SYNTAX/DESCR=<MMS file> parameter", so the parameter is treated as a target.

If the user defined command is COM file, it is executed like "@<COM file> parameter".

Note: it is recommended that user-defined build procedure creates resulting files in <project root>/<output folder>/<build label> directory. So does default procedure.

In the CLEAN operation parameter will be just "CLEAN" string.

Editing of builds is the same as editing of project settings.

To change current build configuration click "Change" on the buildName: line.

To debug a project, there must be a build configuration named DEBUG.

Changes in task2cmd: parameter for any build and clean command must be named build configuration label.