Build a Feathers UI project as a Linux app
Feathers UI may be used to build desktop applications targeting Linux distributions.
Prerequisites
In addition to the dependencies specified in the Feathers UI installation instructions, building a Linux application with Feathers UI has some additional requirements.
- A computer running a distribution of Linux. Linux apps cannot be built on other operating systems, such as Windows or macOS.
No additional software needs to be installed on most Linux computers. If you need to build 32-bit apps from a 64-bit distribution, see the official Linux setup instructions for Lime/OpenFL.
Build
To build for the linux
target, run the following command.
openfl build linux
Use the -debug
flag to create a build to include extra debugging information, including full stack traces when there's an exception or crash.
openfl build linux -debug
The build's output will be written to the bin/linux/bin folder.
Your project.xml file may optionally specify an output folder different from bin.
<app path="Export"/>
In the example above, the output would be generated in Export/linux/bin instead.
Run / Debug
OpenFL provides the test
command to compile and launch your project executable on Linux.
openfl test linux
Troubleshooting
In the future, common error messages and their solutions will appear in this section.
Did you get some other error message that you don't understand?
Configuring OpenFL to build for native targets, like Linux or Windows, can be a little tricky! Head over to either the Feathers UI community forum or the Feathers UI Discord. Explain which command you tried to run, be sure to mention that you are targeting linux, and post the error message (and any additional relevant output). Ideally, we can help you figure out a solution, and then we'll also add it to this troubleshooting section, so that everyone can benefit.