https://devblogs.microsoft.com/dotnet/introducing-dotnet-maui-one-codebase-many-platforms/ Skip to main content [RE1Mu3b] Microsoft .NET Blog .NET Blog .NET Blog * Home * DevBlogs * Developer + Visual Studio + Visual Studio Code + Visual Studio for Mac + DevOps + Developer support + CSE Developer + Engineering@Microsoft + Azure SDK + IoT + Command Line + Perf and Diagnostics + Dr. International + Notification Hubs + Math in Office * Technology + DirectX + PIX + SurfaceDuo + Startups + Sustainable Engineering + Windows AI Platform * Languages + C++ + C# + F# + Visual Basic + TypeScript + PowerShell Community + PowerShell Team + Python + Q# + JavaScript + Java + Java Blog in Chinese * .NET + .NET + .NET MAUI + Blazor + ASP.NET + NuGet + Xamarin * Platform Development + #ifdef Windows + Apps for Windows + Azure Depth Platform + Azure Government + Bing Dev Center + Microsoft Edge Dev + Microsoft Azure + Microsoft 365 Developer + Old New Thing + Windows MIDI and Music dev + Windows Search Platform * Data Development + Azure Cosmos DB + Azure Data Studio + Azure SQL Database + OData + Revolutions R + SQL Server Data Tools * More [ ] Search Search Cancel Introducing .NET MAUI - One Codebase, Many Platforms [png] David Ortinau May 23rd, 20228 Welcome to .NET Multi-platform App UI. This release marks a new milestone in our multi-year journey to unify the .NET platform. Now you and over 5 million other .NET developers have a first-class, cross-platform UI stack targeting Android, iOS, macOS, and Windows to complement the .NET toolchain (SDK) and base class library (BCL). You can build anything with .NET. Join us at Microsoft Build 2022 where we'll give you a tour of all the updates for building native apps for any device with .NET and Visual Studio. >> Learn more. This is just the beginning of our journey to create a desktop and mobile app experience that delights .NET developers. For the next phase, the foundation is now established for the broader .NET ecosystem to bring plugins, libraries, and services from .NET Framework and the old project system to .NET 6 and SDK style projects. Among those available today are: syncfusion controls for dot net telerik controls for dot net maui maui DevExpress controls for dot net grial kit controls for .NET MAUI maui AndroidX Google APIs for iOS Plugin.StoreReview AlohaKit Google Play Services Plugin.ValidationRules CommunityToolkit.MVVM Client Libraries ReactiveUI.Maui CommunityToolkit.Maui GrialKit Shiny CommunityToolkit MauiAnimation SkiaSharp MauiCompat Microsoft.Maui.Graphics Syncfusion CommunityToolkit MR.Gestures Telerik UI for .NET Markup.MauiCompat Prism.Maui MAUI DevExpress Plugin.Fingerprint TemplateUI Facebook Plugin.InAppBilling User Dialogs FreshMvvm.Maui For help moving libraries to .NET 6, check out the recent guest blog posts detailing experiences shipping .NET MAUI libraries from Michael Rumpler (MR.Gestures) and Luis Matos (Plugin.ValidationRules). The .NET MAUI workload is fully supported under the Current release schedule of 18 months, and will be serviced at the same monthly cadence as .NET. Our ongoing focus for .NET MAUI continues to be quality, resolving known issues and prioritizing issues based on your feedback. This also includes the workloads we ship for building applications that exclusively target Android, Android Wear, CarPlay, iOS, macOS, and tvOS directly using the native toolkits from .NET, and the supporting libraries AndroidX, Facebook, Firebase, Google Play Services, and SkiaSharp. With .NET MAUI you can achieve no-compromise user experiences while sharing more code than ever before. .NET MAUI uses native UI via the premier app toolkits provided by each platform, modern developer productivity, and our fastest mobile platform yet. Native UI, No Compromise The primary goal of .NET MAUI is to enable you to deliver the best app experience as designed specially by each platform (Android, iOS, macOS, and Windows), while enabling you to craft consistent brand experiences through rich styling and graphics. Out of the box, each platform looks and behaves the way it should without any additional widgets or styling required to mimic. For example, .NET MAUI on Windows is backed by WinUI 3 the premier native UI component that ships with the Windows App SDK. app UI on all four supported platforms Use C# and XAML to build your apps from a rich toolkit of more than 40 controls, layouts, and pages. Upon the Xamarin shoulders of mobile controls, .NET MAUI adds support for multi-window desktop applications, menu bars, and new animation capabilities, borders, corners, shadows, graphics, and more. Oh, and the new BlazorWebView which I'll highlight below. Image controls sample png Read more in the .NET MAUI documentation about controls: pages, layouts, and views. Accessibility First One major advantage of using native UI is the inherited accessibility support that we can build upon with semantic services to make it easier than ever to create highly accessible applications. We have worked closely with customers to redesign how we develop for accessibility. From these conversations we have designed .NET MAUI semantic services for controlling: * Properties such as description, hint, and heading level * Focus * Screen reader * Automation properties Read more in the .NET MAUI documentation about semantic services for accessibility. Beyond UI .NET MAUI provides simple APIs to access services and features of each platform such as accelerometer, app actions, file system, notifications, and so much more. In this example, we configure "app actions" that add menu options to the app icon on each platform: AppActions.SetAsync( new AppAction("current_info", "Check Current Weather", icon: "current_info"), new AppAction("add_location", "Add a Location", icon: "add_location") ); Image platform integrations png Read more in the .NET MAUI documentation about accessing platform services and features. Easily Customized Whether you're extending the capabilities of .NET MAUI controls or establishing new platform functionality, .NET MAUI is architected for extensibility, so you never hit a wall. Take, for example, the Entry control - a canonical example of a control that renders differently on one platform. Android draws an underline below the text field, and developers often want to remove that underline. With .NET MAUI, customizing every Entry in your entire project is just a few lines of code: #if ANDROID Microsoft.Maui.Handlers.EntryHandler.Mapper.ModifyMapping("NoUnderline", (h, v) => { h.PlatformView.BackgroundTintList = ColorStateList.ValueOf(Colors.Transparent.ToPlatform()); }); #endif android default entry control compared to a styled entry control Here is a great recent example of creating a new Map platform control by Cayas Software. The blog post demonstrates creating a handler for the control, implementation for each platform, and then making the control available by registering it in .NET MAUI. .ConfigureMauiHandlers(handlers => { handlers.AddHandler(typeof(MapHandlerDemo.Maps.Map),typeof(MapHandler)); }) Image maui maps png Read more in the .NET MAUI documentation about customizing controls with handlers Modern Developer Productivity More than being a technology that can build anything, we want .NET to also accelerate your productivity using common language features, patterns and practices, and tooling. .NET MAUI uses the new C# 10 features introduced in .NET 6, including global using statements and file scoped namespaces - great for reducing clutter and cruft in your files. And .NET MAUI takes multi-targeting to a new level with "single project" focus. Image code side by side png In new .NET MAUI projects, the platforms are nestled away in a subfolder giving focus to your application where you spend the majority of your effort. Within your project's Resources folder you have a single place to manage your app's fonts, images, app icon, splash screen, raw assets, and styling. .NET MAUI will do the work to optimize them for each platform's unique requirements. solution explorer showing platform and resources folders Multi-project vs Single project Structuring your solution with Individual projects for each platform is still supported, so you can choose when the single project approach is appropriate for your applications. .NET MAUI uses the builder pattern made popular with Microsoft.Extensions libraries in ASP.NET and Blazor applications as a single place to initialize and configure your app. From here, you can provide .NET MAUI with your fonts, tap into platform specific lifecycle events, configure dependencies, enable specific features, enable vendor control toolkits, and more. public static class MauiProgram { public static MauiApp CreateMauiApp() { var builder = MauiApp.CreateBuilder(); builder .UseMauiApp() .ConfigureServices() .ConfigureFonts(fonts => { fonts.AddFont("Segoe-Ui-Bold.ttf", "SegoeUiBold"); fonts.AddFont("Segoe-Ui-Regular.ttf", "SegoeUiRegular"); fonts.AddFont("Segoe-Ui-Semibold.ttf", "SegoeUiSemibold"); fonts.AddFont("Segoe-Ui-Semilight.ttf", "SegoeUiSemilight"); }); return builder.Build(); } } public static class ServicesExtensions { public static MauiAppBuilder ConfigureServices(this MauiAppBuilder builder) { builder.Services.AddMauiBlazorWebView(); builder.Services.AddSingleton(); builder.Services.AddSingleton(); builder.Services.AddSingleton(); #if WINDOWS builder.Services.TryAddSingleton(); #elif ANDROID builder.Services.TryAddSingleton(); #elif MACCATALYST builder.Services.TryAddSingleton(); builder.Services.TryAddSingleton< Platforms.MacCatalyst.ConnectivityService>(); #elif IOS builder.Services.TryAddSingleton(); #endif builder.Services.TryAddTransient(); builder.Services.TryAddSingleton(); builder.Services.AddScoped(); builder.Services.AddScoped(); builder.Services.AddScoped(_ => new ListenTogetherHubClient(Config.ListenTogetherUrl)); return builder; } } Read more in the .NET MAUI documentation about app startup with MauiProgram and single project. Bringing Blazor to Desktop and Mobile .NET MAUI is also great for web developers looking to get in on the action with native client apps. .NET MAUI integrates with Blazor, so you can reuse existing Blazor web UI components directly in native mobile and desktop apps. With .NET MAUI and Blazor, you can reuse your web development skills to build cross-platform native client apps, and build a single UI that spans mobile, desktop, and web. .NET MAUI Blazor on mobile, desktop, and web .NET MAUI executes your Blazor components natively on the device (no WebAssembly needed) and renders them to an embedded web view control. Because your Blazor components compile and execute in the .NET process, they aren't limited to the web platform and can leverage any native platform feature, like notifications, Bluetooth, geo-location and sensors, filesystem, and so much more. You can even add native UI controls alongside your Blazor web UI. This is an all new kind of hybrid app: Blazor Hybrid! Getting started with .NET MAUI and Blazor is easy: just use the included .NET MAUI Blazor App project template. .NET MAUI Blazor app template This template is all setup so you can start building a .NET MAUI Blazor app using HTML, CSS, and C#. The Blazor Hybrid tutorial for .NET MAUI will walk you through building and running your first .NET MAUI Blazor app. Or add a BlazorWebView control to an existing .NET MAUI app wherever you want to start using Blazor components: Blazor Hybrid support is also now available for WPF and Windows Forms so you can start modernizing your existing desktop apps to run on the web or to run cross platform with .NET MAUI. The BlazorWebView controls for WPF and Windows Forms are available on NuGet. Check out the Blazor Hybrid tutorials for WPF and Windows Forms to learn how to get started. To learn more about Blazor Hybrid support for .NET MAUI, WPF, and Windows forms, check out the Blazor Hybrid docs. Optimized for Speed .NET MAUI is designed for performance. You have told us how critical it is for your applications to start as quickly as possible, especially on Android. The UI controls in .NET MAUI implement a thin, decoupled handler-mapper pattern over the native platform controls. This reduces the number of layers in the rendering of UI and simplifies control customization. The layouts in .NET MAUI have been architected to use a consistent manager pattern that optimizes the measure and arrange loops to more quickly render and update your UI. We have also surfaced layouts pre-optimized for specific scenarios such as HorizontalStackLayout and VerticalStackLayout in addition to StackLayout. From the very beginning of this journey, we set a goal to improve startup performance and maintain or reduce app size as we transitioned to .NET 6. At the time of GA, we've achieved a 34.9% improvement for .NET MAUI and 39.4% improvement in .NET for Android. Those gains extend to complex apps as well; the .NET Podcast sample application began with a startup of 1299ms and at GA measures 814.2ms, a 37.3% improvement since Preview 13. The settings are enabled by default to provide a release build with these optimizations. Image android release settings Stay tuned for a deep-dive blog post on what we have done to achieve these results. Get Started Today To get started using .NET MAUI on Windows, install or update Visual Studio 2022 Preview to version 17.3 Preview 1.1. In the installer, choose the workload ".NET Multi-platform App UI development". dot net maui workload in visual studio installer To use .NET MAUI on Mac, install the new Visual Studio 2022 preview for Mac (17.3 Preview 1). Visual Studio 2022 will GA .NET MAUI tooling support later this year. On Windows today you can accelerate your dev loop with XAML and .NET Hot Reload, and powerful editors for XAML, C#, Razor, and CSS among others. Using the XAML Live Preview and Live Visual Tree, you can preview, align, inspect your UI, and edit it while debugging. .NET MAUI's new single project experience now includes project property pages for a visual editing experience to configure your apps with multi-platform targeting. On Mac, you can today load single project and multi-project .NET MAUI solutions to debug with a beautiful, new native Visual Studio 2022 for Mac experience. Other features for enhancing your productivity developing .NET MAUI applications will ship in subsequent previews. We recommend getting started updating your libraries to .NET MAUI and creating new .NET MAUI projects today. Before diving headlong into converting Xamarin projects to .NET MAUI, review your dependencies, the state of Visual Studio support for .NET MAUI, and the published known issues to identify the right time to transition. Keep in mind that Xamarin will continue to be supported under the modern lifecycle policy, which states 2 years from the last major release. Resources * .NET MAUI - Workshop * Building your first .NET MAUI app * Documentation * Known Issues * Microsoft Learn Path * Q&A Forums * Release Notes * Samples * Support Policy - .NET MAUI * Support Policy - Xamarin We need your feedback We'd love to hear from you! As you encounter any issues, file a report on GitHub at dotnet/maui. Summary With .NET MAUI, you can build native applications for Android, iOS, macOS, and Windows from a single codebase using the same productivity patterns practiced all across .NET. The thin and decoupled UI and layout architecture of .NET MAUI together with single project features enable you to stay focused on one application instead of juggling the unique needs of multiple platforms. And with .NET 6, we're shipping performance improvements not only for Android, but all across the breadth of platform targets. Less platform code, more shared code, consistent standards and patterns, lightweight and performant architecture, mobile and desktop native experiences - this is just the beginning. We look forward to seeing libraries and the broader ecosystem come alongside .NET MAUI in the following months to define a new era of cross-platform application development for .NET developers that empowers you and your organization to achieve more. Get Started [png] David Ortinau Principal Product Manager, .NET Multi-platform App UI Follow Posted in .NET .NET MAUITagged .net maui releases Read next What's new with ML.NET Automated ML (AutoML) and tooling Check out what's new with ML.NET Automated ML (AutoML), tooling, and notebooks! [png]Luis Quintanilla May 17, 2022 0 comment The Azure Cosmos DB Journey to .NET 6 Azure Cosmos DB is a fully-managed, multi-tenant, distributed, shared-nothing, horizontally scalable database that provides planet-scale NoSQL capabilities offering APIs ... [png]Vinod Sridharan May 12, 2022 4 comments 8 comments Leave a commentCancel reply Log in to join the discussion. * [png] Siggi Ullrich May 23, 2022 12:46 pm collapse this comment Just great Log in to Reply * [png] Yahor Sinkevich May 23, 2022 1:02 pm collapse this comment web? Log in to Reply + [png] David OrtinauMicrosoft employee May 23, 2022 1:53 pm collapse this comment If you're targeting web, we recommend Blazor for that, and then bringing those components to desktop and mobile with .NET MAUI and BlazorWebView. Today for taking a mobile or desktop UI to web, we'd recommend considering Uno. I'd be interested in learning more about your interest and need. Shoot me a message if you've like to discuss. david.ortinau@microsoft.com Log in to Reply * [png] Nathan Loum May 23, 2022 1:31 pm collapse this comment Congratulations, nicely done! Is there a schedule on when the MVU coding style will be available? Are you guys still planning on making Comet the official MVU option for .NET MAUI? Log in to Reply + [png] David OrtinauMicrosoft employee May 23, 2022 1:56 pm collapse this comment Comet will be shipping a version based on .NET MAUI GA, and we will be ramping up our activity there in the coming weeks. It'll continue as an experiment for the time being as we determine what investment we should make based on developer usage and need. Log in to Reply * [png] Jin Park May 23, 2022 2:48 pm collapse this comment I think I somehow messed up my mac m1 while removing old dotnet versions. With everything installed on todays version or even the last RC I can restore and build any other template types such as web but when I do: dotnet new maui -n "MauiProj" and do a "dotnet restore" in that directory I get a bunch of nuget errors like below. Its like nuget is only looking for linux versions. Anyone have any ideas? /Users/user/temp/MauiProj/MauiProj.csproj : error NU1102: Unable to find package Microsoft.NETCore.App.Host.linux-arm with version (= 6.0.5) [/Users/user/temp/MauiProj/MauiProj.sln] /Users/user/temp/MauiProj/MauiProj.csproj : error NU1102: - Found 84 version(s) in nuget.org [ Nearest version: 7.0.0-preview.1.22076.8 ] [/Users/user/temp/MauiProj/ MauiProj.sln] /Users/user/temp/MauiProj/MauiProj.csproj : error NU1102: - Found 0 version(s) in /usr/local/share/dotnet/library-packs [/Users/ user/temp/MauiProj/MauiProj.sln] Log in to Reply * [png] M San May 23, 2022 2:58 pm collapse this comment Teams desktop and Skype are excellent candidates for Blazor MAUI dogfooding IMO. Log in to Reply * [png] Daniel Smith May 23, 2022 3:57 pm collapse this comment Would it be possible to support Blazor WebAssembly PWAs as a target platform in the future? You'd automatically have access to .NET with that, and it would cover all the remaining gaps (Linux & web) with a single target. I ask this because I've been playing with Blazor PWAs recently. You've got complete flexibility to choose any web UI framework, however I couldn't help thinking that it would be great if there was a bunch of helper controls and layouts like MAUI has. If you can translate XAML to native controls on iOS and Android etc, then surely it's feasible to translate the visuals to HTML with bit of CSS magic Log in to Reply Relevant Links .NET Download .NET Hello World .NET Meetup Events .NET Documentation .NET API Browser .NET SDKs .NET Application Architecture Guides Web apps with ASP.NET Core Mobile apps with Xamarin.Forms Microservices with Docker Containers Modernizing existing .NET apps to the cloud Archive May 2022 April 2022 March 2022 February 2022 January 2022 December 2021 November 2021 October 2021 September 2021 August 2021 July 2021 June 2021 May 2021 April 2021 March 2021 February 2021 January 2021 December 2020 November 2020 October 2020 September 2020 August 2020 July 2020 June 2020 May 2020 April 2020 March 2020 February 2020 January 2020 December 2019 November 2019 October 2019 September 2019 August 2019 July 2019 June 2019 May 2019 April 2019 March 2019 February 2019 January 2019 December 2018 November 2018 October 2018 September 2018 August 2018 July 2018 June 2018 May 2018 April 2018 March 2018 February 2018 January 2018 December 2017 November 2017 October 2017 September 2017 August 2017 July 2017 June 2017 May 2017 April 2017 March 2017 February 2017 January 2017 December 2016 November 2016 October 2016 September 2016 August 2016 July 2016 June 2016 May 2016 April 2016 March 2016 February 2016 January 2016 December 2015 November 2015 October 2015 September 2015 August 2015 July 2015 June 2015 May 2015 April 2015 March 2015 February 2015 January 2015 December 2014 November 2014 October 2014 September 2014 August 2014 July 2014 June 2014 May 2014 April 2014 March 2014 February 2014 January 2014 December 2013 November 2013 October 2013 September 2013 August 2013 July 2013 June 2013 May 2013 April 2013 March 2013 February 2013 January 2013 December 2012 November 2012 October 2012 September 2012 August 2012 July 2012 June 2012 May 2012 April 2012 March 2012 February 2012 January 2012 October 2011 September 2011 August 2011 June 2011 April 2011 March 2011 February 2011 January 2011 December 2010 November 2010 October 2010 September 2010 August 2010 July 2010 June 2010 May 2010 April 2010 March 2010 February 2010 December 2009 November 2009 October 2009 September 2009 August 2009 July 2009 June 2009 May 2009 April 2009 March 2009 February 2009 January 2009 December 2008 November 2008 October 2008 September 2008 August 2008 July 2008 June 2008 May 2008 April 2008 March 2008 February 2008 January 2008 December 2007 November 2007 October 2007 September 2007 August 2007 July 2007 June 2007 May 2007 April 2007 March 2007 February 2007 January 2007 December 2006 November 2006 October 2006 September 2006 August 2006 July 2006 June 2006 May 2006 April 2006 March 2006 February 2006 January 2006 October 2005 July 2005 May 2005 December 2004 November 2004 September 2004 June 2004 Topics .NET ASP.NET .NET Core ASP.NET Core .NET Framework Blazor Entity Framework C# Azure Visual Studio WPF ML.NET Performance Machine Learning .NET MAUI F# WinForms AI Machine Learning .NET Internals Security SignalR Containers Community Standup Conversations Maintenance & Updates Cloud WCF Developer Stories Game Development Lifecycle Debugging Show dotnet Networking Docker WebHooks Maoni Async Concurrency GC TPL Visual Basic Static Analysis Featured GitHub Actions Apache Big Data Spark for .NET IoT Orchard Core SQL Server JSON LOH gRPC XAML Stay informed Login Insert/edit link Close Enter the destination URL URL [ ] Link Text [ ] [ ] Open link in a new tab Or link to existing content Search [ ] No search term specified. Showing recent items. Search or use up and down arrow keys to select an item. Cancel [Add Link] Code Block x Paste your code snippet [ ] Cancel Ok What's new * Surface Pro 8 * Surface Laptop Studio * Surface Pro X * Surface Go 3 * Surface Duo 2 * Surface Pro 7+ * Windows 11 apps * HoloLens 2 Microsoft Store * Account profile * Download Center * Microsoft Store support * Returns * Order tracking * Virtual workshops and training * Microsoft Store Promise * Flexible Payments Education * Microsoft in education * Devices for education * Microsoft Teams for Education * Microsoft 365 Education * Education consultation appointment * Educator training and development * Deals for students and parents * Azure for students Business * Microsoft Cloud * Microsoft Security * Azure * Dynamics 365 * Microsoft 365 * Microsoft Advertising * Microsoft Industry * Microsoft Teams Developer & IT * Developer Center * Documentation * Microsoft Learn * Microsoft Tech Community * Azure Marketplace * AppSource * Microsoft Power Platform * Visual Studio Company * Careers * About Microsoft * Company news * Privacy at Microsoft * Investors * Diversity and inclusion * Accessibility * Security English (United States) * Sitemap * Contact Microsoft * Privacy * Manage cookies * Terms of use * Trademarks * Safety & eco * About our ads * (c) Microsoft 2022