Main Content

Troubleshooting Custom Toolchain Validation

Build Tool Command Path Incorrect

If the path or command file name are not correct, validation displays:

Cannot find file 'path+command'. The file does not exist.

Consider the following two lines from an example toolchain definition file:

tool.setCommand('abc');
tool.setPath('/toolchain/');
To correct this issue:

  • Check that the build tool is installed.

  • Review the arguments given for the tool.setCommand and tool.setPath lines in toolchain definition file.

Build Tool Not in System Path

When the build tool’s path is not provided and the command file is not in the system path, validation displays:

Cannot find 'command'. It is not in the system path.

Consider the following two lines from an example toolchain definition file:

tool.setCommand('icl');
tool.setPath('');

Because the argument for setPath() is '' instead of an absolute path, the build tool must be on the system path.

To correct this issue:

  • Use coder.make.ToolchainInfo.ShellSetup property to add the path to the toolchain installation.

  • Use your system setup to add the toolchain installation directory to system environment path.

Otherwise, replace '' with the absolute path of the command file.

Tool Path Does Not Exist

If the path of the build tool path is provided, but does not exist, validation displays:

Path 'toolpath' does not exist.

To correct this issue:

  • Check the actual path of the build tool. Then, update the value of coder.make.BuildTool.setPath in the toolchain definition file.

  • Use your system setup to add the toolchain installation directory to system environment path. Then, set the value of coder.make.BuildTool.setPath to ''.

Path Incompatible with Builder or Build Tool

If the file separator character in the build tool path (for example '/' or '\') is not compatible with the builder application, validation can display:

Path 'toolpath' does not exist.

To correct this issue, check that the file separators in the toolchain definition match the 'FileSeparator' accepted by the tc.BuilderApplication when the specified path is used by the make file. Then, update the value of coder.make.BuildTool.setPath in the toolchain definition file.

Most toolchains and build tools recognize '/' as a file separator. To get your custom toolchain definitions to behave as expected, try using '/' as the file separator.

Unsupported Platform

If the toolchain is not supported on the host computer platform, validation displays:

Toolchain 'tlchn' is supported on a 'pltfrma' platform. 
However, you are running on a 'pltfrmb' platform.

To correct this issue:

  • Check the coder.make.ToolchainInfo.Platform property in your toolchain definition file for errors.

  • Update or replace the toolchain definition file with one that supports your host computer platform.

  • Change host computer platforms.

Toolchain is Not installed

If the toolchain is not installed, validation displays:

Toolchain is not installed

To correct this issue, install the expected toolchain, or verify that you selected the correct toolchain, as described in Use the Custom Toolchain.