Troubleshooting

The purpose of this page is to collect problems and solutions that users on various platforms have had with the Lingua Franca tools. If you have suggestions for additions to this page, please submit a pull request.

Environment Issues

The Lingua Franca tools rely on being able to invoke various external programs such as cmake, target-language compilers, Python, and Node.js. If any of these programs is missing, you will get an error message suggesting that you install the program. If you install the program and the error message persists, this usually means that the program is not visible in the environment in which the Lingua Franca tool is being run.

The simplest approach to diagnosing the problem is to first verify that the command-line tools work. For example, on the command line:

$ lfc --version
lfc 0.2.1
$ cmake --version
cmake version 3.22.2
$ lfc src/MyFile.lf
... successful compile ...

If you then have trouble compiling the same file using the Visual Studio Code extension, then it is executing in a different environment that may not have the same PATH variable and may, for example, fail to find some external program or invoke a different version of that program.

On many platforms, one way to ensure that the Visual Studio Code extension uses the same environment as the command-line tools, is to invoke them on the command line. For example:

$ code .

This way, the tool inherits the environment from the shell from which you invoke it. Often, that environment is quite different from what you get if, for example, you launch the shell from the graphical user interface.