Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Draft] Readme WIP #1

Merged
merged 1 commit into from
May 14, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 67 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,77 @@
# .NET Multi-platform App UI (MAUI)
# Introducing .NET Multi-platform App UI (MAUI)

Maui is the planned future home of [Xamarin.Forms](https://github.com/xamarin/xamarin.forms) to align with the release of .NET 6.
Maui is:

## Status
* Multi-platform native UI
* Deploy to multiple devices across mobile & desktop
* Using a single project, single codebase
* Evolution of [Xamarin.Forms](https://github.com/xamarin/xamarin.forms)
* Targeting .NET 6, previews end of year

Active development is happening today in Xamarin.Forms and preview releases will initially be made from xamarin/xamarin.forms.
## Status: Planning and Development

While [Xamarin.Forms](https://github.com/xamarin/xamarin.forms) continues to be actively developed to meet customer needs today, we are [proposing evolutionary changes](../../issues) during this planning phase based on some early customer interviews of what would be most beneficial.

Active development is happening today to build Android and iOS SDKs against the next version of .NET. [Samples may be found here](https://github.com/xamarin/net5-samples).

### Goals

* Improve app performance
* Improve simplicity of control extensibility
* Improve simplicity of contributing
* Enable developer options to use Model-View-Update (MVU) and Blazor

### Roadmap

.NET Maui and mobile SDK support will ship in concert with .NET 6. At present we do not have a shipping schedule for .NET 6.

### Milestones

* Maui previews Q4 2020 through Q3 2021
* [Renderer architecture revisions](tbd)
* [Source solution and project simplification](tbd)
* [Completete approved proposals]()
* [Implement MVU]()
* Maui release candidate September 2021
* Maui general availability November 2021


## Source Code

This is an evolution of [Xamarin.Forms](https://github.com/xamarin/xamarin.forms). Preview releases of Maui will initially be made from [xamarin/xamarin.forms](https://github.com/xamarin/xamarin.forms). As we slow development in Xamarin.Forms and near the transition to Maui, code will be moved to this repository.

## Xamarin.Forms vs Maui


| |Xamarin.Forms |Maui |
|---------|---------|---------|
|**Platforms** | | |
|Android |API 19+ |API 21+ |
|iOS |9-13 |10+ |
|Linux |Community |Community |
|macOS |Community |Microsoft |
|Tizen |Samsung |Samsung |
|Windows |UWP Microsoft<br/>WPF Community |WinUI 3 Microsoft<br/>WPF Community |
|**Features** | | |
|Renderers |Tightly coupled to BindableObject |Loosely coupled, no Core dependencies |
|App Models |MVVM, RxUI |MVVM, RxUI, MVU, Blazor |
|Single Project |No |Yes |
|Multi-targeting |No |Yes |
|Multi-window |No |Yes |
|**Misc** | | |
|.NET |Xamarin.iOS, Xamarin.Android, Mono, .NET Framework, ... |.NET 6+ |
|Acquisition |NuGet & Visual Studio Installer |dotnet |
|Project System |Franken-proj |SDK Style |
|dotnet CLI |No |Yes |
|**Tools** | | |
|Visual Studio 2019 |Yes |Yes |
|Visual Studio 2019 for Mac |Yes |Yes |
|Visual Studio Code |No |Yes |

## How to Engage, Contribute, and Give Feedback

Some of the best ways to contribute are to try things out, file issues, join in design conversations,
and make pull-requests. Proposals for changes specific to Maui can be found [here for discussion](./issues).
and make pull-requests. Proposals for changes specific to Maui can be found [here for discussion](../../issues).

## Code of conduct

Expand Down