Desktop

import { Tabs, TabItem } from '@astrojs/starlight/components';

Generally, Slint runs on Windows, macOS, and popular Linux distributions. The following tables cover versions that we specifically test. The general objective is to support the operating systems that are supported by their vendors at the time of a Slint version release.

Handle the Console Window

When you running an application a console window will show by default.

Disable the console by specifying a WINDOWS subsystem.

When running the application from the command line, if the subsystem is set to windows it will no longer output stdout. To get it back consider using FreeConsole().

See more details at #3235

Add the code to the top of .rs file which contains fn main():

#![windows_subsystem = "windows"]

Or if you want to keep console output in debug mode:

#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]

Select the WINDOWS subsystem by setting the WIN32_EXECUTABLE target property on your executable target:

add_executable(my_program ...)
set_property(TARGET my_program APPEND PROPERTY WIN32_EXECUTABLE TRUE)

Rust: Stack Overflows

When developing Rust applications on Windows, you might sooner or later observe the program aborting with STATUS_STACK_OVERFLOW, especially in debug builds. This is a known issue that's a combination of a high demand for stack space and MSVC defaulting to a stack size for the main thread that's significantly smaller compared to other operating systems.

This is fixed by configuring the linker. Create a .cargo\config.toml file in your project (note the .cargo sub-directory) with the following contents:

[target.x86_64-pc-windows-msvc]
# Increase default stack size to avoid running out of stack
# space in debug builds. The size matches Linux's default.
rustflags = ["-C", "link-arg=/STACK:8000000"]
[target.aarch64-pc-windows-msvc]
# Increase default stack size to avoid running out of stack
# space in debug builds. The size matches Linux's default.
rustflags = ["-C", "link-arg=/STACK:8000000"]

Linux desktop distribution present a diverse landscape, and Slint should run on any of them, provided that they are using Wayland or X-Windows, glibc, and d-bus. If a Linux distribution provides Long Term Support (LTS), Slint should run on the most recent LTS or newer, at the time of a Slint version release. </TabItem> </Tabs>

Other Platforms

Contact us if you want to use Slint on other platforms/versions.