Biblioteca de interfaz de usuario de Windows 3 - Project Reunion 0.5 (marzo de 2021)Windows UI Library 3 - Project Reunion 0.5 (March 2021)

La biblioteca de interfaz de usuario de Windows (WinUI) 3 es un marco nativo de experiencia de usuario (UX) para crear aplicaciones de Windows modernas.Windows UI Library (WinUI) 3 is a native user experience (UX) framework for building modern Windows apps. Se distribuye independientemente del sistema operativo Windows, como parte de Project Reunion.It ships independently from the Windows operating system as a part of Project Reunion. La versión de Project Reunion 0.5 proporciona plantillas de proyecto de Visual Studio para ayudarle a empezar a crear aplicaciones con una interfaz de usuario basada en WinUI 3.The Project Reunion 0.5 release provides Visual Studio project templates to help you start building apps with a WinUI 3-based user interface.

WinUI 3 - Project Reunion 0.5 es la primera versión estable y compatible de WinUI 3 que se puede usar para crear aplicaciones de producción que se pueden publicar en Microsoft Store.WinUI 3 - Project Reunion 0.5 is the first stable, supported version of WinUI 3 that can be used to create production apps that can be published to the Microsoft Store. Esta versión consta de las actualizaciones de estabilidad y las mejoras generales que permiten que WinUI 3 sea compatible con versiones posteriores y esté lista para producción.This release consists of the stability updates and general improvements that allow WinUI 3 to be forward-compatible and production-ready.

Instalación de WinUI 3 - Project Reunion 0.5Install WinUI 3 - Project Reunion 0.5

Esta nueva versión de WinUI 3 está disponible como parte de Project Reunion 0.5.This new version of WinUI 3 is available as part of Project Reunion 0.5. Para instalarla, consulte:To install, see:

Instrucciones de instalación para Project Reunion 0.5Installation instructions for Project Reunion 0.5

Ahora que WinUI se incluye como parte de Project Reunion, para empezar, descargará la extensión de Visual Studio (VSIX) para Project Reunion, que incluye un conjunto de herramientas y componentes para desarrolladores.Now that WinUI ships as a part of Project Reunion, you'll download the Project Reunion Visual Studio Extension (VSIX) to get started, which includes a set of developer tools and components. Para obtener más información sobre el paquete de Project Reunion, consulte Implementación de aplicaciones que usan Project Reunion.For more on the Project Reunion package, see Deploy apps that use Project Reunion. El VSIX de Project Reunion incluye plantillas de proyecto de WinUI que usará para compilar la aplicación para WinUI 3.The Project Reunion VSIX includes WinUI Project Templates that you'll use to build your WinUI 3 app.

Nota

Para ver en acción los controles y las características de WinUI 3, puede clonar y compilar la versión de WinUI 3 de la Galería de controles de XAML desde GitHub.To see WinUI 3 controls and features in action, you can clone and build the WinUI 3 version of the XAML Controls Gallery from GitHub.

Nota

Para usar las herramientas de WinUI 3, como Árbol visual dinámico, Recarga activa y Explorador de propiedades dinámico, debe habilitar las herramientas de WinUI 3 con las características de Visual Studio Preview, tal como se describe en estas instrucciones.To use WinUI 3 tooling such as Live Visual Tree, Hot Reload, and Live Property Explorer, you must enable WinUI 3 tooling with Visual Studio Preview Features as described in the instructions here.

Una vez que haya configurado el entorno de desarrollo, consulte las plantillas de proyecto de WinUI 3 en Visual Studio para familiarizarse con las plantillas de proyectos y de elementos de Visual Studio disponibles.Once you've set up your development environment, see WinUI 3 project templates in Visual Studio to familiarize yourself with the available Visual Studio Project and Item templates.

Para obtener más información sobre cómo empezar a trabajar con la compilación de una aplicación para WinUI 3, consulte los siguientes artículos:For more information about getting started with building a WinUI 3 app, see the following articles:

Además de las limitaciones y los problemas conocidos, compilar una aplicación con los proyectos WinUI es similar a compilar una aplicación para UWP con XAML y WinUI 2.x.Aside from the limitations and known issues, building an app using the WinUI projects is similar to building a UWP app with XAML and WinUI 2.x. Por lo tanto, se pueden aplicar la mayor parte de la documentación sobre las instrucciones de las aplicaciones para UWP y los espacios de nombres de WinRT de Windows.UI de Windows SDK.Therefore, most of the guidance documentation for UWP apps and the Windows.UI WinRT namespaces in the Windows SDK is applicable.

La documentación de referencia de la API de WinUI 3 está disponible aquí: referencia de la API de WinUI 3.WinUI 3 API reference documentation is available here: WinUI 3 API Reference

WebView2WebView2

Para usar WebView2 con esta versión de WinUI 3, descargue Evergreen Bootstrapper o el instalador independiente de Evergreen que se encuentra en esta página si aún no tiene instalado el entorno de ejecución de WebView2.To use WebView2 with this WinUI 3 release, please download the Evergreen Bootstrapper or Evergreen Standalone Installer found on this page if you don't already have the WebView2 Runtime installed.

Kit de la comunidad de WindowsWindows Community Toolkit

Si usa Windows Community Toolkit, descargue la versión más reciente.If you're using the Windows Community Toolkit, download the latest version.

Compatibilidad de Visual StudioVisual Studio Support

Para aprovechar las últimas características de las herramientas agregadas a WinUI 3, como Recarga activa, Árbol visual dinámico y Explorador de propiedades dinámico, debe usar la versión preliminar más reciente de Visual Studio, y asegurarse de habilitar las herramientas de WinUI en las características de Visual Studio Preview, según se describe en estas instrucciones.In order to take advantage of the latest tooling features added into WinUI 3 like Hot Reload, Live Visual Tree, and Live Property Explorer, you must use the latest preview version of Visual Studio and be sure to enable WinUI tooling in Visual Studio Preview Features, as described in the instructions here. En la tabla siguiente se muestra la compatibilidad de las versiones de Visual Studio 2019 con WinUI 3 - Project Reunion 0.5:The table below shows the compatibility of Visual Studio 2019 versions with WinUI 3 - Project Reunion 0.5:

Versión de VSVS Version WinUI 3 - Project Reunion 0.5WinUI 3 - Project Reunion 0.5
16.816.8 NoNo
16,916.9 Sí, pero sin Recarga activa, Árbol visual dinámico ni Explorador de propiedades dinámicoYes, but with no Hot Reload, Live Visual Tree, or Live Property Explorer
Versiones preliminares 16.1016.10 Previews Sí, con todas las herramientas de WinUI 3Yes, with all WinUI 3 tooling

Actualización de la aplicación para WinUI 3 existenteUpdating your existing WinUI 3 app

Puede actualizar una aplicación que usaba una versión preliminar de WinUI 3 para usar esta nueva versión compatible de WinUI 3.You can update an app that was using a preview version of WinUI 3 to use this new supported version of WinUI 3. Consulte las instrucciones siguientes en función del tipo de aplicación.See instructions below based on your app type.

Nota

Estas instrucciones pueden tener problemas debido a la unicidad del escenario individual de cada aplicación.These instructions may have issues due to the uniqueness of each app's individual scenario. Sígalas atentamente y, si encuentra problemas, registre un error en nuestro repositorio de GitHub.Please carefully follow them and if you find issues, file a bug on our GitHub repo.

Actualización de una aplicación para WinUI 3, versión preliminar 4 para usar WinUI 3 - Project Reunion 0.5Updating a WinUI 3 Preview 4 app to use WinUI 3 - Project Reunion 0.5

Antes de comenzar, asegúrese de que tiene instalados todos los requisitos previos de WinUI 3 - Project Reunion 0.5, incluidos el VSIX y el paquete NuGet de Project Reunion.Before starting, make sure you have all the WinUI 3 - Project Reunion 0.5 prerequisites installed, including the Project Reunion VSIX and NuGet package. Consulte las instrucciones de instalación aquí.See installation instructions here.

En primer lugar, asegúrese de seguir los pasos a continuación:First, be sure to go through the following steps:

  • En el archivo .wapproj, si el valor de TargetPlatformMinVersion es anterior a 10.0.17763.0, cámbielo a 10.0.17763.0In the .wapproj file, if your TargetPlatformMinVersion is older than 10.0.17763.0, change it to 10.0.17763.0

  • Si la aplicación usa el evento Application.Suspending, asegúrese de quitar o cambiar esa línea, debido a que ya no se llama a Application.Suspending para las aplicaciones de escritorio.If your app uses the Application.Suspending event, be sure to remove or change that line since Application.Suspending is no longer called for desktop apps. Consulte la documentación de la referencia de API para obtener más información.See the API reference documentation for more info.

    Tenga en cuenta que las plantillas de proyecto predeterminadas para las aplicaciones de C++ y C# incluyen las líneas siguientes.Note that the default project templates for both C++ and C# apps included the following lines. Asegúrese de quitar estas líneas si todavía están presentes en el código:Be sure to remove these lines if they are still present in your code:

    C#: this.Suspending += OnSuspending;C#: this.Suspending += OnSuspending;

    C++: Suspending({ this, &App::OnSuspending });C++: Suspending({ this, &App::OnSuspending });

Ahora, haga algunos cambios en el proyecto:Now, make some changes to your project:

  1. En Visual Studio, vaya a Herramientas -> Administrador de paquetes NuGet -> Consola del administrador de paquetes.In Visual Studio, go to Tools -> Nuget Package Manager -> Package Manager Console.

  2. Escriba uninstall-package Microsoft.WinUI -ProjectName {yourProject}Type uninstall-package Microsoft.WinUI -ProjectName {yourProject}

  3. Escriba install-package Microsoft.ProjectReunion -Version 0.5.0 -ProjectName {yourProjectName}Type install-package Microsoft.ProjectReunion -Version 0.5.0 -ProjectName {yourProjectName}

  4. Haga los cambios siguientes en la aplicación (paquete).wapproj:Make the following changes in your Application (package).wapproj:

    Agregue esta sección:Add this section:

    <ItemGroup>
      <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0]">
        <IncludeAssets>build</IncludeAssets>
      </PackageReference>
    </ItemGroup>
    

    Luego quite las líneas siguientes:Then remove the following lines:

    <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
    
    <Import Project="$(AppxTargetsLocation)Microsoft.WinUI.AppX.targets" />
    
  5. Elimine el archivo Microsoft.WinUI.AppX.targets existente en la carpeta {SuProyecto}(paquete)/compilación/ del proyecto.Delete the existing Microsoft.WinUI.AppX.targets file under the {YourProject}(package)/build/ folder of your project.

Actualización de una aplicación para WinUI 3 - Project Reunion 0,5 (versión preliminar) para usar WinUI 3 - Project Reunion 0.5 (estable)Updating a WinUI 3 - Project Reunion 0.5 Preview app to use WinUI 3 - Project Reunion 0.5 (Stable)

Antes de comenzar, asegúrese de que tiene instalados todos los requisitos previos de WinUI 3 - Project Reunion 0.5, incluidos el VSIX y el paquete NuGet de Project Reunion.Before starting, make sure you have all the WinUI 3 - Project Reunion 0.5 prerequisites installed, including the Project Reunion VSIX and NuGet package. Consulte las instrucciones de instalación aquí.See installation instructions here.

En primer lugar, asegúrese de seguir los pasos a continuación:First, be sure to go through the following steps:

  • En el archivo .wapproj, si el valor de TargetPlatformMinVersion es anterior a 10.0.17763.0, cámbielo a 10.0.17763.0In the .wapproj file, if your TargetPlatformMinVersion is older than 10.0.17763.0, change it to 10.0.17763.0

  • Si la aplicación usa el evento Application.Suspending, asegúrese de quitar o cambiar esa línea, debido a que ya no se llama a Application.Suspending para las aplicaciones de escritorio.If your app uses the Application.Suspending event, be sure to remove or change that line since Application.Suspending is no longer called for desktop apps. Consulte la documentación de la referencia de API para obtener más información.See the API reference documentation for more info.

    Tenga en cuenta que las plantillas de proyecto predeterminadas para las aplicaciones de C++ y C# incluyen las líneas siguientes.Note that the default project templates for both C++ and C# apps included the following lines. Asegúrese de quitar estas líneas si todavía están presentes en el código:Be sure to remove these lines if they are still present in your code:

    C#: this.Suspending += OnSuspending;C#: this.Suspending += OnSuspending;

    C++: Suspending({ this, &App::OnSuspending });C++: Suspending({ this, &App::OnSuspending });

Ahora, haga algunos cambios en el proyecto:Now, make some changes to your project:

  1. En Visual Studio, vaya a Herramientas -> Administrador de paquetes NuGet -> Consola del administrador de paquetes.In Visual Studio, go to Tools -> Nuget Package Manager -> Package Manager Console.

  2. Escriba uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}Type uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}

  3. Escriba uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}Type uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}

  4. Escriba uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}Type uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}

  5. Escriba install-package Microsoft.ProjectReunion -Version 0.5.0 -ProjectName {yourProjectName}Type install-package Microsoft.ProjectReunion -Version 0.5.0 -ProjectName {yourProjectName}

  6. Haga los cambios siguientes en la aplicación (paquete).wapproj:Make the following changes in your Application (package).wapproj:

    Agregue esta sección:Add this section:

      <ItemGroup>
        <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0]">
          <IncludeAssets>build</IncludeAssets>
        </PackageReference>
      </ItemGroup>
    

    Luego quite las líneas siguientes:Then remove the following lines:

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
    

    yand

      <Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" />
      <Import Project="$(Microsoft_WinUI_AppX_targets)" />
    

    y este grupo de elementos:and this item group:

    <ItemGroup>
        <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
          <ExcludeAssets>all</ExcludeAssets>
        </PackageReference>
        <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
          <ExcludeAssets>all</ExcludeAssets>
        </PackageReference>
      </ItemGroup>
    

Principales cambios introducidos en esta versiónMajor changes introduced in this release

Características establesStable features

Esta versión proporciona la estabilidad y el soporte para que WinUI 3 sea adecuado para las aplicaciones de producción que se pueden enviar a Microsoft Store.This release provides the stability and support to make WinUI 3 suitable for production apps that can ship to the Microsoft Store. Incluye soporte y compatibilidad con versiones posteriores para la mayoría de las características introducidas en las versiones preliminares anteriores:It includes support and forward compatibility for most features introduced in past previews:

  • Capacidad para crear aplicaciones de escritorio con WinUI, incluido .NET 5 para aplicaciones Win32Ability to create desktop apps with WinUI, including .NET 5 for Win32 apps
  • RadialGradientBrushRadialGradientBrush
  • Actualizaciones de TabViewTabView updates
  • Actualizaciones de temas oscurosDark theme updates
  • Mejoras y actualizaciones para WebView2Improvements and updates to WebView2
    • Compatibilidad con valores altos de PPPSupport for High DPI
    • Compatibilidad con el cambio de tamaño y desplazamiento de ventanasSupport for window resizing and moving
    • Actualizado para poder usar una versión más reciente de EdgeUpdated to target more recent version of Edge
    • Desaparece la necesidad de hacer referencia a un paquete NuGet específico de WebView2No longer necessary to reference a WebView2-specific Nuget package
  • SwapChainPanelSwapChainPanel
  • Compatibilidad con MRT CoreMRT Core Support
    • Esto hace que las aplicaciones sean más rápidas y ligeras en el inicio y proporciona una búsqueda de recursos más rápida.This makes apps faster and lighter on startup and provides quicker resource lookup.
  • Compatibilidad con ARM64ARM64 Support
  • Arrastrar y colocar dentro y fuera de las aplicacionesDrag and drop inside and outside of apps
  • RenderTargetBitmap (actualmente solo contenido XAML, sin contenido SwapChainPanel)RenderTargetBitmap (currently only XAML content - no SwapChainPanel content)
  • Compatibilidad con cursores personalizadosCustom cursor support
  • Entrada fuera de subprocesoOff-thread input
  • Mejoras en nuestra experiencia del desarrollador o herramientas:Improvements to our tooling/developer experience:
    • Árbol visual dinámico, recarga activa, explorador de propiedades dinámico y herramientas similaresLive Visual Tree, Hot Reload, Live Property Explorer and similar tools
    • IntelliSense para WinUI 3Intellisense for WinUI 3
  • Mejoras necesarias para la migración del código abiertoImprovements required for open source migration
  • Funcionalidades de barra de título personalizadas: nuevas API Window.ExtendsContentIntoTitleBar y Window.SetTitleBar, que permiten a los desarrolladores crear barras de título personalizadas en aplicaciones de escritorio.Custom titlebar capabilities: new Window.ExtendsContentIntoTitleBar and Window.SetTitleBar APIs that allow developers to create custom title bars in desktop apps.
  • Compatibilidad con VirtualSurfaceImageSourceVirtualSurfaceImageSource support
  • Acrílico en la aplicaciónIn-app acrylic

Características en vista previaPreview features

Dado que se trata de una versión estable, se han quitado las características de versión preliminar de la versión de WinUI 3.As this is a stable release, preview features have been removed from this version of WinUI 3. Todavía puede acceder a estas características mediante la versión preliminar actual de WinUI 3.You can still access these features by using the current preview version of WinUI 3. Tenga en cuenta que las siguientes características clave están todavía en versión preliminar y que se sigue trabajando para estabilizarlas:Please note the following key features are still in preview, and work to stabilize them is ongoing:

Comentarios y sugerenciasProvide feedback and suggestions

Agradecemos todos los comentarios que dejéis en el repositorio de WinUI de GitHub.We welcome your feedback in the WinUI GitHub repo.

¿Qué novedades se esperan?What's coming next?

Para obtener más información sobre para cuándo están planeadas características específicas, consulte la Hoja de ruta de características en GitHub.For more information on when specific features are planned, see the feature roadmap on GitHub.

Limitaciones y problemas conocidosLimitations and known issues

Estos son algunos de los problemas conocidos que pueden aparecer en WinUI 3 - Project Reunion 0.5.The following items are some of the known issues with WinUI 3 - Project Reunion 0.5. Si encuentra algún problema que no se muestra a continuación, háganoslo saber colaborando en un problema existente o presentando un nuevo problema en el repositorio de WinUI de GitHub.If you find an issue that isn't listed below, please let us know by contributing to an existing issue or filing a new issue through the WinUI GitHub repo.

Compatibilidad con la plataforma y el sistema operativoPlatform and OS support

WinUI 3 - Project Reunion 0.5 es compatible con equipos en los que se ejecuta la Actualización de octubre de 2018 de Windows 10 (versión 1809, compilación 17763), o cualquier versión más reciente.WinUI 3 - Project Reunion 0.5 is compatible with PCs running the Windows 10 October 2018 Update (version 1809 - build 17763) and newer.

Herramientas para desarrolladoresDeveloper tools

  • Solo se admiten las aplicaciones C# y C++/WinRT.Only C# and C++/WinRT apps are supported
  • Las aplicaciones de escritorio admiten .NET 5 y C# 9, y se deben empaquetar en una aplicación MSIX.Desktop apps support .NET 5 and C# 9, and must be packaged in an MSIX app
  • No existe compatibilidad con el Diseñador XAML.No XAML Designer support
  • No se admiten las nuevas aplicaciones escritas en C++/CX. Sin embargo, las aplicaciones existentes seguirán funcionando (es aconsejable empezar a usar  C++/WinRT lo antes posible)New C++/CX apps are not supported, however, your existing apps will continue to function (please move to C++/WinRT as soon as possible)
  • No se admite la implementación de dispositivos de escritorio sin empaquetarUnpackaged desktop deployment is not supported
  • Al ejecutar una aplicación de escritorio con F5, asegúrese de que está ejecutando el proyecto de empaquetado.When running a desktop app using F5, make sure that you are running the packaging project. Si presiona F5 en el proyecto de aplicación, se ejecutará una aplicación sin empaquetar, que ya no es compatible con WinUI 3.Hitting F5 on the app project will run an unpackaged app, which WinUI 3 does not yet support.

Faltan características de la plataformaMissing Platform Features

  • Compatibilidad con XboxXbox support

  • Compatibilidad con HoloLensHoloLens support

  • Elementos emergentes con ventanasWindowed popups

    • Más concretamente, la propiedad ShouldConstrainToRootBounds siempre actúa como si estuviera establecida en true, independientemente del valor de la propiedad.More specifically, the ShouldConstrainToRootBounds property always acts as if it's set to true, regardless of the property value.
  • Compatibilidad con entrada de lápiz, lo que incluye:Inking support, including:

  • Acrílico en el fondoBackground acrylic

  • MediaElement y MediaPlayerElementMediaElement and MediaPlayerElement

  • MapControlMapControl

  • SwapChainPanel no admite la transparenciaSwapChainPanel does not support transparency

  • Global Reveal usa el comportamiento de reserva, que es un pincel sólidoGlobal Reveal uses fallback behavior, a solid brush

  • XAML Islands no se admite en esta versiónXAML Islands is not supported in this release

  • El uso de WinUI 3 directamente en una aplicación de escritorio existente que no es para WinUI tiene la siguiente limitación: la ruta de acceso disponible actualmente para migrar una aplicación existente es agregar un nuevo proyecto de WinUI 3 a la solución, y ajustar o refactorizar la lógica según sea necesario.Using WinUI 3 directly in an existing non-WinUI desktop app has the following limitation: The currently available path for migrating an existing app is to add a new WinUI 3 project to your solution, and adjust or refactor your logic as needed.

  • No se llama a Application.Suspending en aplicaciones de escritorio.Application.Suspending is not called in desktop apps. Consulte la documentación de la referencia de API en el Evento Application.Suspending para obtener más detalles.See API reference documentation on the Application.Suspending Event for more details.

  • CoreWindow, ApplicationView, CoreApplicationView, CoreDispatcher y sus dependencias no se admiten en aplicaciones de escritorio (consulte a continuación).CoreWindow, ApplicationView, CoreApplicationView, CoreDispatcher and their dependencies are not supported in desktop apps (see below)

CoreWindow, ApplicationView, CoreApplicationView y CoreDispatcher en aplicaciones de escritorioCoreWindow, ApplicationView, CoreApplicationView, and CoreDispatcher in desktop apps

Novedades de WinUI 3, versión preliminar 4, y de serie a partir de este momento, CoreWindow, ApplicationView, CoreApplicationView, CoreDispatcher y sus dependencias no están disponibles en aplicaciones de escritorio.New in WinUI 3 Preview 4 and standard going forward, CoreWindow, ApplicationView, CoreApplicationView CoreDispatcher, and their dependencies are not available in desktop apps. Por ejemplo, la propiedad Window.Dispatcher siempre es NULL, pero se puede usar la propiedad Window.DispatcherQueue como alternativa.For example, the Window.Dispatcher property is always null, but the Window.DispatcherQueue property can be used as an alternative.

Estas API solo funcionan en aplicaciones para UWP.These APIs only work in UWP apps. En las versiones preliminares anteriores, también funcionaban parcialmente en aplicaciones de escritorio, pero desde la versión preliminar 4 se deshabilitaron por completo.In past previews they've partially worked in desktop apps as well, but since Preview 4 they've been fully disabled. Estas API están diseñadas para el caso de UWP donde solo hay una ventana por subproceso, y una de las características futuras de WinUI 3 es habilitar varias.These APIs are designed for the UWP case where there is only one window per thread, and one of the features of WinUI 3 is to enable multiple in the future.

Hay API que dependen internamente de la existencia de estas API que, por tanto, no se admiten en una aplicación de escritorio.There are APIs that internally depend on existence of these APIs, which consequently aren't supported in a desktop app. En general, estas API tienen un método GetForCurrentView estático.These APIs generally have a static GetForCurrentView method. Por ejemplo UIViewSettings.GetForCurrentView.For example UIViewSettings.GetForCurrentView.

Para obtener más información sobre las API afectadas, así como las soluciones alternativas y los reemplazos de dichas API, consulte los cambios de la API de WinRT para aplicaciones de escritorio.For more information on affected APIs as well as workarounds and replacements for these APIs, please see WinRT API changes for desktop apps

Problemas conocidosKnown issues

  • Alt+F4 no cierra las ventanas de la aplicación de escritorio.Alt+F4 does not close desktop app windows.

  • El evento UISettings.ColorValuesChanged y el evento AccessibilitySettings.HighContrastChanged ya no se admiten en las aplicaciones de escritorio.The UISettings.ColorValuesChanged Event and AccessibilitySettings.HighContrastChanged Event are no longer supported in desktop apps. Esto puede generar problemas si los usa para detectar cambios en los temas de Windows.This may cause issues if you are using it to detect changes in Windows themes.

  • Anteriormente, para obtener una instancia de CompositionCapabilities, llamaría a CompositionCapabilites.GetForCurrentView().Previously, to get a CompositionCapabilities instance you would call CompositionCapabilites.GetForCurrentView(). Sin embargo, las funcionalidades devueltas por esta llamada no dependían de la vista.However, the capabilities returned from this call were not dependent on the view. Para abordar y reflejar esto, hemos eliminado el método estático GetForCurrentView() en esta versión, por lo que ahora puede crear un objeto CompositionCapabilties directamente.To address and reflect this, we've deleted the GetForCurrentView() static in this release, so now you can create a CompositionCapabilties object directly.

  • El pincel acrílico se representa de manera transparente.Acrylic brush renders transparent.

  • Debido a un problema de C#/WinRT, la suscripción a algunos eventos de elementos de marco y la navegación por las páginas pueden provocar pérdidas de memoria.Due to a C#/WinRT issue, subscribing to some framework element events and page navigation can cause memory leaks.

  • Hay otros problemas de C#/WinRT que puede encontrar en esta versión, como GC/ObjectDisposedExceptions, serialización de valores y tipos que aceptan valores NULL (TimeSpan, IReference, etc.).There are other C#/WinRT issues that you may encounter in this release, such as GC/ObjectDisposedExceptions, marshaling value and nullable types (TimeSpan, IReference, etc).

    • Estos se corregirán en la próxima versión de mantenimiento del SDK de .NET 5 que se distribuirá a mediados de abril.These will be fixed in the upcoming .NET 5 SDK servicing release that ships in mid-April. Para obtener esta actualización, puede descargarla e instalarla explícitamente (por ejemplo, en canalizaciones de compilación) o implícitamente a través de la actualización de Visual Studio.You can pick up this update by downloading and installing it explicitly (e.g., in build pipelines) or implicitly via Visual Studio update.

Consulte WinUI 3 Controls Gallery (anteriormente denominada XAML Controls Gallery - versión de WinUI 3) para obtener una aplicación de ejemplo que incluye todos los controles y características que forman parte de WinUI 3 - Project Reunion 0.5.Check out the WinUI 3 Controls Gallery (previously called XAML Controls Gallery - WinUI 3 version) for a sample app that includes all controls and features that are a part of WinUI 3 - Project Reunion 0.5.

Aplicación WinUI 3 Controls GalleryWinUI 3 Controls Gallery app
Ejemplo de aplicación WinUI 3 Controls GalleryExample of the WinUI 3 Controls Gallery app

Para descargar el ejemplo, puede clonar el repositorio de GitHub.You can download the sample by cloning the GitHub repo. Para ello, clone la rama winui3 con el siguiente comando:To do this, clone the winui3 branch using the following command:

git clone --single-branch --branch winui3 https://github.com/microsoft/Xaml-Controls-Gallery.git

Después de la clonación, asegúrese de cambiar a la rama winui3 en su entorno de GIT local:After cloning, ensure that you switch to the winui3 branch in your local Git environment:

git checkout winui3