Skip to content

Commit b4382d1

Browse files
Merge pull request #5368 from MicrosoftDocs/alvinashcraft/main-framework-overview-add-hybrid
Add Blazor Hybrid to overview of framework options
2 parents eb3f27f + 45e8db4 commit b4382d1

File tree

1 file changed

+25
-2
lines changed

1 file changed

+25
-2
lines changed

hub/apps/get-started/index.md

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -127,9 +127,9 @@ You will not have access to the APIs provided by the **Windows App SDK** or .NET
127127

128128
## Other cross-platform options
129129

130-
If you need your app to be cross-platform, in addition to React Native for Desktop, you should consider [.NET MAUI](/dotnet/maui/what-is-maui) or a [Progressive Web App (PWA)](/microsoft-edge/progressive-web-apps-chromium/). There are many other choices available ([here's a list of popular options](../../dev-environment/index.md)), but these are some good starting points.
130+
If you need your app to be cross-platform, in addition to React Native for Desktop, you should consider [.NET MAUI](/dotnet/maui/what-is-maui), [Blazor Hybrid](/aspnet/core/blazor/hybrid/), or a [Progressive Web App (PWA)](/microsoft-edge/progressive-web-apps-chromium/). There are many other choices available ([here's a list of popular options](../../dev-environment/index.md)), but these are some good starting points.
131131

132-
.NET MAUI harnesses the power of WinUI on Windows, while also enabling execution on other operating systems. Another cross-platform option, Progressive Web Apps (PWAs), are websites that function like installed, native apps on Windows and other supported platforms, while functioning like regular websites on browsers.
132+
.NET MAUI harnesses the power of WinUI on Windows, while also enabling execution on other operating systems. Blazor Hybrid blends desktop and mobile native client frameworks with .NET and Blazor. Another cross-platform option, Progressive Web Apps (PWAs), are websites that function like installed, native apps on Windows and other supported platforms, while functioning like regular websites on browsers.
133133

134134
For more information, see the following tabs.
135135

@@ -157,6 +157,29 @@ For more information about .NET MAUI, see the following links:
157157
- [Video Series - .NET MAUI for Beginners](/shows/dotnet-maui-for-beginners/)
158158
- [Build 2022: Build native apps for any device with .NET and Visual Studio](https://www.youtube.com/watch?v=IbwgHJPoE-M)
159159

160+
### [Blazor Hybrid](#tab/blazor-hybrid)
161+
162+
In an ASP.NET Core Blazor Hybrid app, [Razor components](/aspnet/core/blazor/components/) run natively on the desktop or mobile device. Components render to a custom embedded Web View control through a local interop channel. The components don't run in the browser, and WebAssembly isn't used. Components have full access to the native capabilities of the device through the .NET platform. All component styles rendered in a Web View are platform dependent. If you're planning to deploy across multiple platforms, you may have to account for rendering differences across the platforms using custom stylesheets.
163+
164+
Blazor Hybrid apps can be built using .NET MAUI, WPF, or Windows Forms. Visual Studio provides a template for creating a Blazor Hybrid app using .NET MAUI. You can also create a Blazor Hybrid app using WPF or Windows Forms by adding a BlazorWebView control to your existing WPF or Windows Forms app. See the links below for more information.
165+
166+
Blazor Hybrid is a great choice if:
167+
168+
- Your team is already familiar with ASP.NET Core, Razor components, and CSS.
169+
- You want to use C# and/or Razor components for building cross-platform apps.
170+
- You want to share as much .NET code (and Razor components) as possible across applications.
171+
- You want to ship your application beyond Windows to other desktop and mobile targets with native platform experiences.
172+
- You have existing .NET MAUI, WPF, or Windows Forms apps and want to add Blazor components to them.
173+
174+
For more information about Blazor Hybrid, see the following links:
175+
176+
- [ASP.NET Core Blazor Hybrid documentation](/aspnet/core/blazor/hybrid/)
177+
- [Build a .NET MAUI Blazor Hybrid app](/aspnet/core/blazor/hybrid/tutorials/maui)
178+
- [Build a Windows Presentation Foundation (WPF) Blazor app](/aspnet/core/blazor/hybrid/tutorials/wpf)
179+
- [Build a Windows Forms Blazor app](/aspnet/core/blazor/hybrid/tutorials/windows-forms)
180+
- [Troubleshoot ASP.NET Core Blazor Hybrid](/aspnet/core/blazor/hybrid/troubleshoot)
181+
- [BlazorWebView Class](/dotnet/api/microsoft.aspnetcore.components.webview.maui.blazorwebview)
182+
160183
### [Progressive Web Apps (PWAs)](#tab/pwa)
161184

162185
[Progressive Web Apps (PWAs)](/microsoft-edge/progressive-web-apps-chromium/) provide access to open web technologies to provide cross-platform interoperability. PWAs provide your users with an app-like experience that's customized for their devices. PWAs are websites that are [progressively enhanced](https://alistapart.com/article/understandingprogressiveenhancement) to function like installed, native apps on supporting platforms (including Windows), while functioning like regular websites on other browsers.

0 commit comments

Comments
 (0)