Decir Windows Neighborhood Toolkit v7.0

-Michael A. Hawker

Download

Después de muchos meses de revitalizar el Windows Neighborhood Toolkit con una multitud de mejoras y características, ¡nos complace anunciar que la versión 7.0 ya está disponible! Se ha recuperado gracias a la ayuda y las contribuciones de nuestro grupo de desarrolladores.

Si no conoce el kit de herramientas, Windows Neighborhood Toolkit es un grupo de asistentes, extensiones y controles personalizados. Simplifica y demuestra tareas frecuentes de los desarrolladores para crear aplicaciones UWP y.Net para Windows 10. El kit de herramientas es parte de.Web Foundation. Puede descargar nuestro área de juegos de aplicaciones de muestra para descubrir y probar los componentes del kit de herramientas antes de comenzar un proyecto.

Esta nueva actualización consta de una biblioteca MVVM personalizada.Net completamente nueva, ayudantes de notificación Toast más fáciles de usar tanto para.Net como para UWP, un sistema de animación de composición completamente renovado para C# y XAML, nuevos controles y mucho más.

Esta es una de las versiones más importantes del Toolkit hasta la fecha, ya que nos embarcamos en optimizar y agilizar el Toolkit para el futuro. Sin embargo, también contiene muchos cambios importantes que debemos tener en cuenta tanto en su estructura subyacente como en los contratos de código. Asegúrese de leer nuestras notas de la versión aquí, a continuación se ofrecen algunas descripciones generales de alto nivel.

Debería haber algo para todos en esta versión porque contiene una amplia cantidad de características; esperamos que las disfrutes para crear aplicaciones.Net y UWP en Windows 10.

Vea más detalles de dichas modificaciones y nuevas opciones a continuación.

Nueva construcción de paquetes y cambios importantes

Hemos refactorizado muchos paquetes en todo el kit de herramientas. Esto fue para ayudar a reducir la necesidad de incorporar dependencias adicionales para todo el paquete cuando solo una pequeña cantidad de elementos las requerían. This has allowed us to cut back the application measurement footprint affect of the Toolkit in frequent situations by 80-90%. Esto nos ha permitido reducir el impacto de la medición de la aplicación del Toolkit en situaciones frecuentes en un 80-90%.

If you're new to the Toolkit or creating a new application, you can skip this part and bounce to our new features under! Si eres nuevo en el Kit de herramientas o estás creando una nueva aplicación, puedes omitir esta parte y pasar a nuestras nuevas funciones a continuación.

La refactorización que hemos completado ha afectado principalmente a los paquetes de animaciones y controles. A continuación, se muestran los aspectos más destacados de los cambios más impactantes, pero consulte nuestras notas de la versión para obtener todos los detalles.

El paquete de animación ahora es más liviano para admitir solo animaciones C# y XAML directamente.

We've got split the Behaviors reference into a new Microsoft.Toolkit.Uwp.UI.Behaviors package which includes varied new Behaviors and new hooks into Animations. Effects that had been within the Animations package deal are now supported by enhancements to the Microsoft.Toolkit.Uwp.UI.Media package which allow for adding effects on to components in addition to animation support. Hemos dividido la referencia de comportamientos en un nuevo paquete Microsoft.Toolkit.Uwp.UI.Behaviors que incluye varios comportamientos nuevos y nuevos enlaces a animaciones. Los efectos que estaban en el paquete de animaciones ahora son compatibles con las mejoras del paquete Microsoft.Toolkit.Uwp.UI.Media que permiten agregar efectos a los componentes además de compatibilidad con animaciones.

El paquete Controles ahora es un metapaquete que contiene varios subpaquetes.

Tener un paquete de protección debería facilitar la actualización. Controles adicionales como DataGrid y los diseños ItemsRepeater ahora también se incluirán de forma predeterminada, lo que le proporcionará acceso a todo lo que Toolkit tiene para ofrecer al comenzar. El paquete de controles ahora se basa en WinUI 2.5, lo que puede ayudarnos a proporcionar un estilo de control más consistente a medida que avanzamos y aprovechamos las últimas correcciones y opciones que la plataforma tiene para ofrecer. Una vez que haya creado una aplicación, ahora puede optimizarla eliminando el paquete de controles general y agregando solo los paquetes con los controles que necesita.

Todas las extensiones se han movido al espacio de nombres raíz de cada paquete para que sea más fácil descubrirlas, usarlas y comprender de dónde provienen.

La mayoría debería simplemente requerir un cambio de espacio de nombres/xmlns para migrar. Aviso: Recomendamos migrar del uso de Dispatcher a DispatcherQueue según las instrucciones de la plataforma. Esto permite el uso de componentes dentro de XAML Islands y WinUI 3.

The Guard and ThrowHelper APIs have been moved to a brand new Microsoft.Toolkit.Diagnostics package deal. Deferred Event helpers have moved to Microsoft.Toolkit as they're.Net Standard appropriate; only the UWP specific event extensions have remained in Microsoft.Toolkit.Uwp. Las API Guard y ThrowHelper se han trasladado a un nuevo paquete llamado Microsoft.Toolkit.Diagnostics. Los ayudantes de eventos diferidos se han trasladado a Microsoft.Toolkit porque son compatibles con.Net Standard; solo las extensiones de eventos específicos de UWP han permanecido en Microsoft.Toolkit.Uwp.

The minimal platform model of the Toolkit's UWP elements is now 1809 (17763) to take away most of our conditional XAML code overhead and snap to the current lengthy-term servicing launch of Home windows 10. We've migrated our Gaze element code to C# for easing maintenance and enhancements sooner or later. We've removed the default Json Serializer dependency from Microsoft.Toolkit.Uwp which was adding a sizeable software footprint overhead even when unused. El modelo de plataforma mínima de los elementos UWP del Toolkit es ahora 1809 (17763) para eliminar la mayor parte de nuestra sobrecarga de código XAML condicional y ajustarse a la versión actual de mantenimiento a largo plazo de Windows 10. Hemos migrado nuestro código de elemento Gaze a C# para facilitar el mantenimiento y las mejoras en el futuro. Hemos eliminado la dependencia predeterminada del serializador JSON de Microsoft.Toolkit.Uwp, que añadía una considerable sobrecarga de espacio de software incluso cuando no se utilizaba.

Note: If upgrading an existing 6.1 app which was storing complicated varieties you'll need to make sure you take a look at upgrading an current knowledge retailer or specifying a Newtonsoft.Json serializer to keep up compatibility along with your current app. Nonetheless, we now enable the app developer to specify whichever serializer they would like to use as a substitute in case they should share knowledge with different aspects of their front/backend. Nota: Si actualiza una aplicación 6.1 existente que almacenaba archivos complejos, deberá asegurarse de actualizar un almacén de datos actual o especificar un serializador Newtonsoft.Json para mantener la compatibilidad con su aplicación actual. Sin embargo, ahora permitimos que el desarrollador de la aplicación especifique el serializador que desee utilizar en su lugar en caso de que necesite compartir datos con otros aspectos de su frontend/backend.

Consulte aquí para obtener orientación adicional sobre cómo especificar un serializador personalizado y ejemplos de uso de System.Textual content.Json, Newtonsoft.Json o DataContractSerializer.

Como parte de este viaje, también hemos mejorado nuestros procesos dentro del propio kit de herramientas, añadiendo pruebas de integración más constantes a nuestra cadena de producción, y ahora tenemos una Wiki con detalles sobre cómo empezar a contribuir al kit de herramientas.

Presentamos el kit de herramientas MVVM para. Internet – Sergio Pedri

El paquete Microsoft.Toolkit.Mvvm es una biblioteca MVVM moderna, rápida y modular. Está construida en torno a los siguientes principios:

Independiente de la plataforma y del entorno de ejecución : .Web Standard 2.x (es decir, independiente del marco de interfaz de usuario) Fácil de configurar y usar : no hay requisitos estrictos sobre la estructura de la aplicación o los paradigmas de codificación (fuera del carácter "MVVM"), es decir, uso flexible. A la carta : libertad para elegir qué componentes utilizar. Implementación de referencia : ágil y de alto rendimiento, ofrece implementaciones para interfaces que pueden incluirse en la biblioteca de clases base de.Net, pero carece de tipos concretos para utilizarlas directamente.

El paquete está destinado a.Net Normal, por lo que se puede utilizar en cualquier plataforma de aplicaciones: UWP, WPF, Xamarin, Uno Platform y más; y en cualquier entorno de ejecución:.Net Native,.Net Core,.Net Framework o Mono. Se ejecuta en todos ellos y proporciona una superficie de API típica para todas las circunstancias.

Esto hace que sea mucho más sencillo resumir la lógica del modelo base y del modelo de vista de la aplicación más adelante, especialmente para proyectos que podrían querer centrarse en varios marcos de interfaz de usuario.

Esta nueva biblioteca ha sido el resultado de un esfuerzo comunitario de casi un año de duración impulsado por Sergio Pedri e inspirado por el trabajo realizado por MVVM Light de Laurent Bugnion. El equipo de Home Windows Template Studio también está brindando soporte para la biblioteca a su conjunto de patrones de diseño. Hemos trabajado con ellos, los MVP de Microsoft (Matt Lacey, James Croft, Nick Randolph, Diederik Krols y Martin Zikmund) y nuestra comunidad para desarrollar, probar y validar las situaciones centrales de la biblioteca antes de su lanzamiento aquí.

Encontrará muestras y más sobre el kit de herramientas MVVM aquí.

Asistente de notificación mejorado para Win32 y.Web 5

¡Las aplicaciones Win32 C# sin empaquetar ahora pueden usar notificaciones sin esfuerzo, sin necesidad de usar un acceso directo en el menú Inicio! ¡Simplemente nombra la siguiente API y listo!

Además, esta misma API simplificada funciona de manera idéntica para aplicaciones UWP y C# empaquetadas de MSIX. No es necesario extender más el ToastNotificationManager.CreateToastNotifier().Present(content.GetXml()).Para hacerlo, consulte la página del documento aquí. ¡Puede ver cómo agregamos notificaciones de extremo a extremo a una aplicación WPF en menos de 2 minutos en este video!

Ayudantes de animación express – Sergio Pedri

Como se mencionó anteriormente, ahora hemos renovado nuestro paquete de animaciones en el kit de herramientas. Sin embargo, además de eso, hemos agregado un nuevo sistema de "animación explícita". Si ha utilizado nuestros asistentes de animación implícita hasta ahora, ¡le encantarán!

No solo contamos con una nueva y sólida clase AnimationBuilder que te ayudará a crear animaciones de composición hermosas y poderosas dentro de C#, sino que también la hemos expuesto a XAML. ¡Mira lo que puedes hacer a continuación ahora sin código subyacente!

Ahora todas tus animaciones de composición se pueden realizar con una API de C# agradable o en XAML similar a nuestros asistentes de animaciones implícitas que han sido tan populares en el pasado. Disfruta y comparte tus creaciones con #WindowsCommunityToolkit en Twitter.

Barra de comandos con pestañas – Yoshi Askharoun

TabbedCommandBar es una interfaz de navegación de nivel de aplicación que ofrece un espacio flexible para controlar los comandos dentro de su aplicación. Ofrece una experiencia conocida que se encuentra en muchas aplicaciones de productividad y permite a un desarrollador de aplicaciones agrupar comandos similares. También proporciona la capacidad de agregar pestañas contextuales para mostrar opciones que pueden ser útiles solo cuando un usuario está realizando cambios específicos en la aplicación.

Selector de colores mejorado – Robert Looyengoed

Después de las discusiones en WinUI GitHub sobre la revitalización de la gestión de ColorPicker, la comunidad dio un paso adelante para visualizar una nueva experiencia para elegir colores. Robert desarrolló una nueva versión de ColorPicker para que todos la usen y prueben. Esperamos brindar comentarios y mejoras basadas en esta nueva experiencia al equipo de la plataforma la próxima vez que actualicen ColorPicker.

Presentador de Switch – Michael Hawker

The SwitchPresenter is a new technique to layout and organize your XAML. It gives the equivalent of a swap statement from C# in XAML! It could make it easier to group components together which might be associated to a situation as an alternative of getting them jumbled along with many Visibility bindings. Or you need to use it to completely swap out a piece of UI easily based on some other issue. Take a look at our example in our docs. SwitchPresenter es una nueva técnica para diseñar y organizar su XAML. ¡Ofrece el equivalente de una declaración swap de C# en XAML! Puede facilitar la agrupación de componentes que podrían estar asociados a una situación en lugar de mezclarlos con muchos enlaces de visibilidad. O puede usarlo para intercambiar por completo una parte de la interfaz de usuario fácilmente en función de algún otro problema. Eche un vistazo a nuestro ejemplo en nuestra documentación.

En el horizonte

Vista previa de Venture Reunion 0.5

Como ya sabrás, hemos estado entregando vistas previas del kit de herramientas que funciona para WinUI 3 junto con sus versiones preliminares. Hemos lanzado una vista previa del kit de herramientas que funciona para aplicaciones de escritorio con.Net en la versión preliminar de Mission Reunion 0.5 lanzada la semana pasada. Obtén más información sobre cómo probarlo aquí.

Ajustes futuros de identificación de paquetes NuGet

CommunityToolkit.WinUI.*. En unas semanas, lanzaremos una versión actualizada de nuestros controles basados ​​en WinUI 3 para NuGet para Project Reunion 0.5. Como parte de este cambio, también comenzaremos a utilizar una nueva raíz de identificación de paquete de CommunityToolkit.* para nuestros paquetes. Nuestros paquetes UWP existentes seguirán siendo CommunityToolkit.WinUI.*.

Nuestro plan puede ser descontinuar los paquetes UWP en algún momento en el futuro, una vez que sintamos que nuestra comunidad en su totalidad puede migrar a WinUI 3 cuando admita las características que nuestra comunidad UWP actual conoce y ama hoy en día. Hasta ese momento, planeamos ayudar a nuestros desarrolladores UWP existentes primero a través de nuestros paquetes actuales creados sobre UWP + WinUI 2.x y enviar versiones paralelas para WinUI 3. Posteriormente, cada lanzamiento posterior del kit de herramientas para UWP (por ejemplo, 7.1) tendrá una versión 7.1 correspondiente que incluya el mismo conjunto de características pero para WinUI 3 (fuera de cualquier cosa que actualmente no sea compatible con WinUI 3 todavía).

¡Aún más!

No olvide consultar también el nuevo analizador de lenguaje Win2D Path Mini de Ratish Philip, las actualizaciones del paquete HighPerformance de Sergio Pedri y las mejoras de la aplicación Lottie Viewer.

¡Hay un montón de correcciones, diferentes ayudantes y mejoras en todos los ámbitos por parte de nuestro grupo en esta versión, así que asegúrese de consultar nuestras notas de lanzamiento para conocer todos los detalles!

Download

¡Empieza hoy mismo!

Como recordatorio, puedes empezar siguiendo nuestro tutorial en docs.microsoft.com o puedes obtener una vista previa de las opciones más nuevas instalando la aplicación Windows Group Toolkit Pattern desde Microsoft Store (también incluye un hipervínculo a cada página del documento). Si deseas contribuir, únete a nosotros en GitHub y consulta nuestra nueva Wiki. Para seguir la conversación en Twitter, usa el hashtag #WindowsCommunityToolkit o únete a nosotros en nuestro canal de Discord de la comunidad UWP.