.NET MAUI - Native embedding

  • Code Sample
Browse code

Typically, a .NET Multi-platform App UI (.NET MAUI) app includes pages that contain layouts, such as Grid, and layouts that contain views, such as Button. Pages, layouts, and views all derive from Element. Native embedding enables any .NET MAUI controls that derive from Element to be consumed in .NET Android, .NET iOS, .NET Mac Catalyst, and WinUI native apps.

The process for consuming a .NET MAUI control in a native app is as follows:

  1. Create extension methods to bootstrap your native embedded app.
  2. Create a .NET MAUI single project that contains your .NET MAUI UI and any dependencies.
  3. Create a native app and enable .NET MAUI support in it.
  4. Initialize .NET MAUI by calling the UseMauiEmbedding extension method.
  5. Create the .NET MAUI UI and convert it to the appropriate native type with the ToPlatformEmbedding extension method.

You must disable hot reload in Visual Studio to run this sample, or run the sample without debugging.

For more information about the sample see Native embedding.