Compartir a través de


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.

    Administrar paquetes NuGet...

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

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.

Uso de los paquetes NuGet

  1. 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);
});
  1. 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.