Introducción al Kit de herramientas de la comunidad de .NET Multi-platform App UI (.NET MAUI)

Este artículo explica cómo empezar a usar los paquetes proporcionados como parte del proyecto del kit de herramientas de la comunidad de .NET MAUI.

Adición de paquetes NuGet

El kit de herramientas está disponible como un conjunto de paquetes NuGet que se pueden agregar a cualquier proyecto existente o nuevo mediante Visual Studio.

1. Abra un proyecto existente o cree uno nuevo según la documentación de configuración de .NET MAUI

2. En el panel Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto y seleccione Administrar paquetes NuGet. Busque CommunityToolkit.Maui y elija el paquete NuGet deseado en la lista.

   

3. Elija los kits de herramientas más adecuados para sus necesidades entre las opciones siguientes:

CommunityToolkit.Maui

Este paquete es una colección de animaciones, comportamientos, convertidores y vistas personalizadas para el desarrollo con .NET MAUI. Simplifica y muestra tareas comunes para desarrolladores que compilan aplicaciones de iOS, Android, macOS y Windows con .NET MAUI.

Nombre del paquete: CommunityToolkit.Maui

Dirección URL del paquete: https://www.nuget.org/packages/CommunityToolkit.Maui

Inicialización del paquete

En primer lugar, se debe agregar la instrucción using a la parte superior del archivo MauiProgram.cs

using CommunityToolkit.Maui;

Para usar correctamente el kit de herramientas, se debe llamar al método UseMauiCommunityToolkit en la clase MauiAppBuilder al arrancar una aplicación el archivo MauiProgram.cs. El siguiente ejemplo muestra cómo hacerlo.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkit()

Para usar las características del kit de herramientas, consulte las páginas de documentación de cada característica específica.

CommunityToolkit.Maui.Markup

Este paquete es un conjunto de clases y métodos auxiliares fluidos para compilar de forma sencilla interfaces de usuario de .NET MAUI declarativas en C#.

Nombre del paquete: CommunityToolkit.Maui.Markup

Dirección URL del paquete: https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

Inicialización del paquete

En primer lugar, se debe agregar la instrucción using a la parte superior del archivo MauiProgram.cs

using CommunityToolkit.Maui.Markup;

Para usar correctamente el kit de herramientas, se debe llamar al método UseMauiCommunityToolkitMarkup en la clase MauiAppBuilder al arrancar una aplicación el archivo MauiProgram.cs. El siguiente ejemplo muestra cómo hacerlo.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMarkup()

Para usar las características del kit de herramientas, consulte las páginas de documentación de cada característica específica.

CommunityToolkit.Maui.Maps

Este paquete le permite mostrar un mapa en la aplicación de .NET MAUI de Windows.

Importante

Mapas de Bing ha dejado de proporcionar nuevas claves de API necesarias para que este control funcione. Actualmente estamos decidiendo si debemos actualizar este control para utilizar el control WinUI que utiliza Azure Maps o si vamos a esperar a la implementación oficial de .NET MAUI de primera parte. Por el momento, esto significa que no puede usar este control si aún no tiene una clave de API de Mapas de Bing. Mapas de Bing en su conjunto dejará de funcionar por completo el 30 de junio de 2025.

Nombre del paquete: CommunityToolkit.Maui.Maps

Dirección URL del paquete: https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

Inicialización del paquete

En primer lugar, se debe agregar la instrucción using a la parte superior del archivo MauiProgram.cs

using CommunityToolkit.Maui.Maps;

Para usar el Map correctamente se debe llamar al método .UseMauiCommunityToolkitMaps en la clase MauiAppBuilder al arrancar una aplicación el archivo MauiProgram.cs. Este método espera una clave de API de Mapas de Bing válida que puede obtener a través del portal de Mapas de Bing.

El siguiente ejemplo muestra cómo hacerlo.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")

Al usar el mapa del kit de herramientas de la comunidad de .NET MAUI para Windows y los mapas de .NET MAUI normales juntos, deberá asegurarse de que cada llamada de inicialización solo se realiza para la plataforma pertinente. El ejemplo siguiente muestra cómo hacerlo.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
#if ANDROID || IOS
    .UseMauiMaps()
#elif WINDOWS
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")
#endif

Para obtener más información sobre cómo inicializar el mapa en iOS y Android, además de cómo trabajar con la API de control de mapa, consulte la documentación de Mapas de .NET MAUI.

CommunityToolkit.Maui.MediaElement

Este paquete le permite reproducir audio y vídeo en la aplicación de .NET MAUI.

Nombre del paquete: CommunityToolkit.Maui.MediaElement

Dirección URL del paquete: https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

Inicialización del paquete

En primer lugar, se debe agregar la instrucción using a la parte superior del archivo MauiProgram.cs

using CommunityToolkit.Maui;

Para poder usar MediaElementcorrectamente el UseMauiCommunityToolkitMediaElement método debe llamarse en la MauiAppBuilder clase al arrancar una aplicación el archivo MauiProgram.cs. El siguiente ejemplo muestra cómo hacerlo.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMediaElement()

Para usar las características del kit de herramientas, consulte las páginas de documentación de cada característica específica.

CommunityToolkit.Maui.Camera

Este paquete le permite conectarse a una cámara, mostrar una vista previa de la cámara y tomar fotos.

Nombre del paquete: CommunityToolkit.Maui.Camera

Dirección URL del paquete: https://www.nuget.org/packages/CommunityToolkit.Maui.Camera

Inicialización del paquete

En primer lugar, se debe agregar la instrucción using a la parte superior del archivo MauiProgram.cs

using CommunityToolkit.Maui;

Para usar correctamente CameraView, se debe llamar al método UseMauiCommunityToolkitCamera en la clase MauiAppBuilder al arrancar una aplicación el archivo MauiProgram.cs. El siguiente ejemplo muestra cómo hacerlo.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitCamera()

Para usar las características del kit de herramientas, consulte las páginas de documentación de cada característica específica.

Uso de los paquetes NuGet

4. Habilite el kit de herramientas en MauiProgram.cs:

var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();
builder.UseMauiCommunityToolkit();

4.1. Para la configuración avanzada, establezca CommunityToolkit.Maui.Options:

builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
});

5. Consulte el resto de la documentación para obtener más información sobre la implementación de características específicas.

Otros recursos

El Repositorio de GitHub del kit de herramientas de la comunidad de .NET MAUI contiene el código fuente de una aplicación de ejemplo diseñada para mostrar cómo puede usar el kit de herramientas para desarrollar una aplicación de .NET MAUI. Tenga en cuenta que deberá clonar o descargar el repositorio y compilar el código fuente para ejecutar la aplicación de ejemplo.

Se recomienda a los desarrolladores que no estén familiarizados con .NET MAUI visitar la documentación de .NET MAUI.

Visite el Repositorio de GitHub del kit de herramientas de la comunidad de .NET MAUI para ver el código fuente actual, descubrir las próximas novedades y clonar el repositorio. Estaremos encantados de recibir cualquier colaboración de la comunidad.