6.4 KiB

Raw Blame History

.NET MAUI Linux Platform

A comprehensive Linux platform implementation for .NET MAUI using SkiaSharp rendering.

Overview

This project brings .NET MAUI to Linux desktops with native X11/Wayland support, hardware-accelerated Skia rendering, and full platform service integration.

Key Features

Full Control Library: 35+ controls including Button, Label, Entry, CarouselView, RefreshView, SwipeView, and more
Native Integration: X11 and Wayland display server support
Accessibility: AT-SPI2 screen reader support and high contrast mode
Platform Services: Clipboard, file picker, notifications, global hotkeys, drag & drop
Input Methods: IBus and XIM support for international text input
High DPI: Automatic scale factor detection for GNOME, KDE, and X11

Quick Start

Installation

# Install the template
dotnet new install Microsoft.Maui.Linux.Templates

# Create a new project
dotnet new maui-linux -n MyApp
cd MyApp

# Run
dotnet run

Manual Installation

dotnet add package Microsoft.Maui.Controls.Linux --prerelease

Supported Controls

Category	Controls
Basic	Button, Label, Entry, Editor, CheckBox, Switch, RadioButton
Layout	StackLayout, ScrollView, Border, Page
Selection	Picker, DatePicker, TimePicker, Slider, Stepper
Display	Image, ImageButton, ActivityIndicator, ProgressBar
Collection	CollectionView, CarouselView, IndicatorView
Gesture	SwipeView, RefreshView
Navigation	NavigationPage, TabbedPage, FlyoutPage, Shell
Menu	MenuBar, MenuFlyout, MenuItem
Graphics	GraphicsView, Border

Platform Services

Service	Description
`ClipboardService`	System clipboard access
`FilePickerService`	Native file open dialogs
`FolderPickerService`	Folder selection dialogs
`NotificationService`	Desktop notifications (libnotify)
`GlobalHotkeyService`	System-wide keyboard shortcuts
`DragDropService`	XDND drag and drop protocol
`LauncherService`	Open URLs and files
`ShareService`	Share content with other apps
`SecureStorageService`	Encrypted credential storage
`PreferencesService`	Application settings
`BrowserService`	Open URLs in default browser
`EmailService`	Compose emails
`SystemTrayService`	System tray icons

Accessibility

AT-SPI2: Screen reader support for ORCA and other assistive technologies
High Contrast: Automatic detection and color palette support
Keyboard Navigation: Full keyboard accessibility

Requirements

.NET 9.0 SDK or later
Linux (kernel 5.4+)
X11 or Wayland
SkiaSharp native libraries

System Dependencies

Ubuntu/Debian:

sudo apt-get install libx11-dev libxrandr-dev libxcursor-dev libxi-dev libgl1-mesa-dev libfontconfig1-dev

Fedora:

sudo dnf install libX11-devel libXrandr-devel libXcursor-devel libXi-devel mesa-libGL-devel fontconfig-devel

Documentation

Sample Application

using Microsoft.Maui.Platform;

var app = new LinuxApplication();

app.MainPage = new ContentPage
{
    Content = new VerticalStackLayout
    {
        Spacing = 10,
        Children =
        {
            new Label
            {
                Text = "Welcome to MAUI on Linux!",
                FontSize = 24
            },
            new Button
            {
                Text = "Click Me"
            },
            new Entry
            {
                Placeholder = "Enter your name"
            }
        }
    }
};

app.Run();

Building from Source

git clone https://github.com/open-maui/maui-linux.git
cd maui-linux
dotnet build
dotnet test

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Architecture

┌─────────────────────────────────────────────────┐
│                  .NET MAUI                       │
│              (Virtual Views)                     │
├─────────────────────────────────────────────────┤
│                  Handlers                        │
│         (Platform Abstraction)                   │
├─────────────────────────────────────────────────┤
│              Skia Views                          │
│        (SkiaButton, SkiaLabel, etc.)            │
├─────────────────────────────────────────────────┤
│           SkiaSharp Rendering                    │
│         (Hardware Accelerated)                   │
├─────────────────────────────────────────────────┤
│              X11 / Wayland                       │
│          (Display Server)                        │
└─────────────────────────────────────────────────┘

Roadmap

Core control library (35+ controls)
Platform services integration
Accessibility (AT-SPI2)
Input method support (IBus/XIM)
High DPI support
Drag and drop
Global hotkeys
Complete Wayland support
Hardware video acceleration
GTK4 interop layer

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

SkiaSharp - 2D graphics library
.NET MAUI - Cross-platform UI framework
The .NET community

6.4 KiB Raw Blame History