Main Page: Difference between revisions

From Wiki Maui Linux NET
Jump to navigation Jump to search
No edit summary
Β 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Maui Linux .NET =
= Maui Linux .NET =


Welcome to **Maui Linux .NET** β€” a community-maintained **fork of Microsoft’s .NET MAUI** to add **Linux support via GtkSharp** (GTK).
In 2022, '''.NET MAUI''' was officially released by Microsoft. However, despite numerous requests from the community, official '''Linux support''' was never provided. Shortly afterward, the '''Maui-Linux''' and '''MauiGtk''' projects were launched with the goal of bringing Linux support to MAUI based on '''GTK''' and '''GtkSharp'''.
This project builds on prior community efforts (see the original **maui-linux** fork) and aims to deliver a usable developer experience on Linux.


''Note:''
To this day, though, MAUI is still not in a state where it can be used productively on Linux.
* This is **not** an official Microsoft platform.
Β 
* It is a **fork** focused on Linux, using **GtkSharp** (GTK) bindings rather than a Skia-only approach. Β 
'''Maui-Linux.NET''' aims to change that β€” by building a central knowledge hub at '''wiki.maui-linux.net''', publishing news and experience reports on '''blog.maui-linux.net''', and maintaining a presence across major '''social media platforms'''.
* See: original fork and discussions for Linux + GTK backend. [Sources]
Β 
Step by step, the goal is to create a strong and dedicated community that will help bring full '''.NET MAUI Linux support''' to life.
Β 
''Note: This project is not affiliated with Microsoft or the official .NET MAUI team.''


----
----


== πŸ“… Timeline ==
== πŸ“… Timeline ==
{| class="wikitable"
{| class="wikitable sortable"
! Date !! Event !! Notes
! Date
! Event
! Description
|-
| May 19–20, 2020
| Announcement
| Microsoft unveils '''.NET Multi-platform App UI (MAUI)''' at Build 2020 as the evolution of Xamarin.Forms.
|-
| August 2021 || First commits to **maui-linux** repository || The project starts under the GitHub account of [https://github.com/jsuarezruiz jsuarezruiz].Β 
|-
| Oct 12, 2021
| Late Previews
| Preview 9 ships alongside .NET 6 RC2 and Visual Studio 2022 Preview 5.
|-
| May 10, 2022
| Release Candidate 3 (Go-Live)
| RC3 arrives with production "go-live" support for developers.
|-
|-
| March 2021 || Community discussion on Linux/GTK for MAUI || Early planning around **GtkSharp** backend. [1]
| May 23–24, 2022
| General Availability (GA)
| '''.NET MAUI''' reaches stable general availability with .NET 6.
|-
|-
| May 23, 2022 || **.NET MAUI 6.0 GA** || First stable MAUI (Android, iOS, macOS, Windows). [2][3]
| Aug 17, 2022
| Tooling GA
| Visual Studio 2022 version 17.3 adds stable .NET MAUI tooling support.
|-
|-
| Nov 8, 2022 || **.NET MAUI 7.0** || Ships with .NET 7. [4]
| Nov 8, 2022
| .NET 7 Wave
| '''.NET MAUI for .NET 7''' ships during .NET Conf 2022 with new features and performance improvements.
|-
|-
| Nov 14, 2023 || **.NET MAUI 8.0 (LTS)** || Major quality & tooling updates. [5]
| Nov 14, 2023
| .NET 8 Wave
| '''.NET MAUI in .NET 8''' goes GA with further performance and reliability updates.
|-
|-
| Nov 12, 2024 || **.NET MAUI 9.0 (GA)** || Performance & control updates. [6][7]
| June 11, 2024
| .NET 8 Integration in MAUI-Linux
| The community-driven '''maui-linux''' project shows first confirmed builds targeting '''.NET 8 (net8.0-gtk)''', indicating the start of .NET 8 integration efforts.
|-
|-
| 2021–2022 || **maui-linux** fork takes shape || Community fork from dotnet/maui to add Linux/GTK. [8][9]
| Nov 12, 2024
| .NET 9 Wave
| '''.NET MAUI 9''' releases (GA) with new controls and a strong focus on quality and stability.
|-
|-
| Oct 2025 || **Maui Linux .NET** (this fork) || Project reboot with focus on docs, builds, and contributor onboarding.
| Sept 11, 2025
| Support Policy Update
| Microsoft updates official support tables β€” MAUI 9 (released Nov 12, 2024) supported until May 12, 2026.
|}
|}
''Sources:''Β 
[1] Linux + GTK discussion (2021) – GtkSharp options.Β 
[2] .NET MAUI GA news (May 2022).Β 
[3] Microsoft support policy page (dates).Β 
[4] Support policy lists MAUI 7 (Nov 2022).Β 
[5] β€œAnnouncing .NET MAUI in .NET 8” (Nov 2023).Β 
[6] β€œAnnouncing .NET 9” (MAUI 9 highlights).Β 
[7] What’s new in .NET MAUI 9 (docs).Β 
[8] **maui-linux** repo (forked from dotnet/maui).Β 
[9] HN/Community notes: fork uses **GtkSharp**.


----
----


== 🚧 Project Status ==
== 🚧 Project Status ==
**Goal:** make MAUI apps run on Linux via **GtkSharp** (GTK backend), with Wayland/X11 support and sane packaging.
Maui Linux .NET aims to make .NET MAUI applications run natively on Linux desktops through a GtkSharp backend.


**Current challenges (why this fork exists):**
However, the original maui-linux project suffered from several core problems:
* **Documentation gaps** – outdated or missing; hard to reproduce a working environment.
* **Stalled upstream activity** – months without meaningful updates in the original fork; open issues linger. [10]
* **Hard to compile** – repeated reports of build failures scare contributors away. [11]
* **Thin community** – without docs and green builds, it’s tough to grow contributors.


**Our focus:** fix the build (scripts/CI), write clear docs, and provide small, verifiable steps to success.
* πŸ“š Lack of documentation – build steps and dependencies were unclear or outdated.
* 🧩 Build failures – even experienced developers struggled to compile a working binary.
* πŸ‘₯ No community traction – without guidance or working examples, contributors lost interest quickly.
Β 
*Maui Linux .NET exists to change that β€” by re-organizing the codebase, documenting every step, and providing working templates for future contributors.


----
----


== πŸ’ͺ Contribute ==
== πŸ’ͺ Contribute ==
We welcome:
If you want to help, you can:
* **Developers:** GTK handlers, windowing, input, WebView (WebKitGTK), packaging (Flatpak/Deb).
Β 
* **Doc writers:** Getting Started, Troubleshooting, Architecture notes.Β 
* Fix and refactor the [https://github.com/TenEniunlsl/GtkSharp GtkSharp] backend.
* **Testers:** Ubuntu/Fedora/Arch; Wayland & X11; HiDPI.
* Develop missing Controls, see [[Implementation Status]]
* Improve documentation (build steps, dependencies, packaging).
* Test on multiple distributions (Ubuntu, Fedora, Arch, openSUSE), see [[How to Start|How_to_start]]
* Add automation (CI pipelines, build scripts, sample apps).


Start here: [[How_to_Start|How to Start]] Β· [[Contributing|Contributing Guide]] Β· [[Roadmap|Roadmap]]
Start here: [[How_to_Start|How to Start]]
If you encounter problems: [[Troubleshooting|Troubleshooting Guide]]


----
----


== 🧭 How to Start ==
== 🧭 How to Start ==
* Follow [[How_to_Start|How to Start]] for prerequisites and the `bootstrap.sh`.Β 
Detailed instructions: [[How_to_Start]]
* Try the sample: `dotnet build` / `dotnet run`.Β 
* If it fails, see [[Troubleshooting]] and open an Issue with logs.


----
----


== πŸ”— External Links ==
== πŸ”— External Links ==
* Original fork: [https://github.com/jsuarezruiz/maui-linux maui-linux (GitHub)]
* Original repository: [https://github.com/jsuarezruiz/maui-linux maui-linux (GitHub)]
* GTK backend community: [https://github.com/MauiGtk MauiGtk Community (GitHub)]Β 
* Official MAUI: [https://github.com/dotnet/maui dotnet/maui (GitHub)]
Β 
----
Β 
== ℹ️ About this Wiki ==
This wiki documents the **Maui Linux .NET** fork for Linux/GTK. It’s maintained by volunteers.Β 
Please improve this page, or contribute via PRs once repo ↔ wiki sync is enabled.
Β 
----
''Last updated: October 2025''

Latest revision as of 11:26, 2 November 2025

Maui Linux .NET

In 2022, .NET MAUI was officially released by Microsoft. However, despite numerous requests from the community, official Linux support was never provided. Shortly afterward, the Maui-Linux and MauiGtk projects were launched with the goal of bringing Linux support to MAUI based on GTK and GtkSharp.

To this day, though, MAUI is still not in a state where it can be used productively on Linux.

Maui-Linux.NET aims to change that β€” by building a central knowledge hub at wiki.maui-linux.net, publishing news and experience reports on blog.maui-linux.net, and maintaining a presence across major social media platforms.

Step by step, the goal is to create a strong and dedicated community that will help bring full .NET MAUI Linux support to life.

Note: This project is not affiliated with Microsoft or the official .NET MAUI team.


πŸ“… Timeline

Date Event Description
May 19–20, 2020 Announcement Microsoft unveils .NET Multi-platform App UI (MAUI) at Build 2020 as the evolution of Xamarin.Forms.
August 2021 First commits to **maui-linux** repository The project starts under the GitHub account of jsuarezruiz.
Oct 12, 2021 Late Previews Preview 9 ships alongside .NET 6 RC2 and Visual Studio 2022 Preview 5.
May 10, 2022 Release Candidate 3 (Go-Live) RC3 arrives with production "go-live" support for developers.
May 23–24, 2022 General Availability (GA) .NET MAUI reaches stable general availability with .NET 6.
Aug 17, 2022 Tooling GA Visual Studio 2022 version 17.3 adds stable .NET MAUI tooling support.
Nov 8, 2022 .NET 7 Wave .NET MAUI for .NET 7 ships during .NET Conf 2022 with new features and performance improvements.
Nov 14, 2023 .NET 8 Wave .NET MAUI in .NET 8 goes GA with further performance and reliability updates.
June 11, 2024 .NET 8 Integration in MAUI-Linux The community-driven maui-linux project shows first confirmed builds targeting .NET 8 (net8.0-gtk), indicating the start of .NET 8 integration efforts.
Nov 12, 2024 .NET 9 Wave .NET MAUI 9 releases (GA) with new controls and a strong focus on quality and stability.
Sept 11, 2025 Support Policy Update Microsoft updates official support tables β€” MAUI 9 (released Nov 12, 2024) supported until May 12, 2026.

🚧 Project Status

Maui Linux .NET aims to make .NET MAUI applications run natively on Linux desktops through a GtkSharp backend.

However, the original maui-linux project suffered from several core problems:

  • πŸ“š Lack of documentation – build steps and dependencies were unclear or outdated.
  • 🧩 Build failures – even experienced developers struggled to compile a working binary.
  • πŸ‘₯ No community traction – without guidance or working examples, contributors lost interest quickly.
  • Maui Linux .NET exists to change that β€” by re-organizing the codebase, documenting every step, and providing working templates for future contributors.

πŸ’ͺ Contribute

If you want to help, you can:

  • Fix and refactor the GtkSharp backend.
  • Develop missing Controls, see Implementation Status
  • Improve documentation (build steps, dependencies, packaging).
  • Test on multiple distributions (Ubuntu, Fedora, Arch, openSUSE), see How_to_start
  • Add automation (CI pipelines, build scripts, sample apps).

Start here: How to Start If you encounter problems: Troubleshooting Guide


🧭 How to Start

Detailed instructions: How_to_Start