Compartilhar via

Notas sobre a versão do canal de pré-visualização para o SDK de Aplicativo do Windows 1.2

  • Artigo

Importante

O canal de preview não é compatível com o uso em ambientes de produção e os aplicativos que usam as versões de preview não podem ser publicados na Microsoft Store.

O canal de pré-visualização do SDK de Aplicativo do Windows com recursos de canal de pré-visualização nos últimos estágios de desenvolvimento. As versões de pré-visualização não incluem recursos experimentais e APIs, mas ainda podem estar sujeitas a alterações significativas antes da próxima versão estável.

Links importantes:

Versão de canal de pré-visualização mais recente:

Versão de canal estável mais recente:

Versão 1.2 Preview 2 (1.2.0-preview2)

Esta é a versão mais recente do canal de preview para a versão 1.2.

Em um SDK do Aplicativo Windows 1.1 existente (do canal estável), você pode atualizar seu pacote Nuget para 1.2.0-preview2 (confira a seção Atualizar um pacote em Instalar e gerenciar pacotes no Visual Studio usando o Gerenciador de Pacotes NuGet).

Para visualizar o runtime atualizado e o MSIX, confira Downloads mais recentes do SDK de Aplicativo do Windows.

Importante

O Visual Studio 2019 e o .NET 5 não têm mais suporte para a criação de aplicativos C# (confira SDK do Aplicativo Windows 1.2 migrando para o C# WinRT 2.0). Você precisará do Visual Studio 2022 e de uma das seguintes versões do SDK do .NET: 6.0.401 (ou posterior), 6.0.304, 6.0.109.

Para atualizar sua versão do SDK do .NET, instale a última versão do Visual Studio 2022 ou visite Downloads do .NET. Ao atualizar seu pacote NuGet sem a versão necessária do SDK do .NET, você visualizará um erro como: "Esta versão do WindowsAppSDK requer .NET 6+ e WinRT.Runtime.dll versão 2.0 ou superior". Para atualizar o projeto do .NET 5.0 para o .NET 6.0, abra o arquivo de projeto e altere "TargetFramework" para net6.0 e "Versão do sistema operacional de destino" para o valor apropriado (como net6.0-windows10.0.19041.0).

Widgets de terceiros no Windows

O quadro de Widgets foi introduzido pela primeira vez no Windows 11 e estava limitado à exibição de widgets internos. Os widgets são pequenos contêineres de interface do usuário que exibem texto e elementos gráficos no quadro de widgets e estão associados a um aplicativo instalado no dispositivo. Com o SDK do Aplicativo Windows, como desenvolvedores de terceiros, agora você pode criar widgets para seus aplicativos do Win32 empacotados e testá-los localmente no quadro de widgets no Windows 11.

Para obter mais informações sobre Widgets, confira Visão geral de widgets.

Para começar a desenvolver os Widgets para seu aplicativo, confira os documentos de desenvolvimento de Provedores de serviços do widget e os Conceitos básicos de design de widgets para pré-requisitos, diretrizes e melhores práticas.

Os pré-requisitos para esta versão incluem:

  • Modo de Desenvolvedor habilitado no computador de desenvolvimento.
  • O computador de desenvolvimento está executando uma versão do Windows do Canal do Desenvolvedor do Programa Windows Insider (WIP) com a versão do quadro de widgets 521.20060.1205.0 ou superior.

Limitações conhecidas ao desenvolver widgets

  • Os widgets de terceiros só podem ser testados localmente em dispositivos registrados no WIP para esta versão prévia. No SDK do Aplicativo Windows 1.2.0, os usuários em versões comerciais do Windows podem começar a adquirir Widgets 3P por meio de versões fornecidas do seu aplicativo pela Microsoft Store.
  • Os widgets só podem ser criados para aplicativos do Win32 empacotados. Os widgets para PWA (Aplicativo Web Progressivo) têm suporte planejado como parte do Microsoft Edge 108.

Corte para aplicativos desenvolvidos com o .NET

Os desenvolvedores .NET agora podem publicar seus aplicativos WinAppSDK cortados. Com o CsWinRT 2.0, as projeções C#/WinRT distribuídas no WinAppSDK agora são aparáveis. Publicar seu aplicativo aparado pode reduzir o volume de disco do aplicativo ao remover qualquer código não utilizado dos binários aparados. Os aplicativos também podem observar uma melhoria no desempenho de inicialização. Com um aplicativo "Olá, Mundo" básico, observamos uma melhoria de cerca de 80% no volume de disco e uma melhoria de desempenho de inicialização de aproximadamente 7% quando publicado o formato aparado. Com a Galeria da WinUI, observamos uma melhoria de aproximadamente 45% no volume de disco.

Para obter mais detalhes sobre como habilitar a aparação, limitações de aparação (como reflexão em relação a tipos aparados) e aparar avisos, confira Aparar implantações autônomas e executáveis. Os desenvolvedores devem testar cuidadosamente seus aplicativos após a aparação para garantir que tudo funcione conforme o esperado. Para obter mais informações, confira o issue n.º 2478 no GitHub.

DisplayInformation

Agora, os aplicativos Win32 podem oferecer suporte ao Alto Alcance Dinâmico (HDR) por meio da classe DisplayInformation no WinAppSDK. A classe DisplayInformation permite monitorar informações relacionadas à exibição de um aplicativo. Isso inclui eventos para permitir que os clientes monitorem alterações na exibição do aplicativo que afetam a tela (ou as telas) na qual a exibição reside, bem como alterações em telas que podem afetar a exibição do aplicativo.

Issues corrigidos no WinUI 3

  • O material de pano de fundo acrílico agora tem suporte em aplicativos Windows 10 por meio do DesktopAcrylicController. Para obter mais informações, confira o issue n.º 7112 no GitHub.
  • Corrigido o issue que fazia com que App.UnhandledException falhasse ao ser roteado para o aplicativo. Para obter mais informações, confira o issue n.º 5221 no GitHub.
  • Corrigido o problema que fazia com que os estilos de ListView regredissem e alterassem do WinAppSDK 1.1. Para obter mais informações, confira o issue n.º 7666 no GitHub.

Outras limitações e problemas conhecidos (1.2.0-preview2)

Importante

Ao referenciar o WinAppSDK 1.2 de um projeto, é possível ver um erro semelhante a: "Downgrade de pacote detectado: Microsoft.Windows.SDK.BuildTools de 10.0.22621.1 para 10.0.22000.194.", que é causado por referências incompatíveis ao pacote do projeto de aplicativo e ao pacote WinAppSDK. Para resolver isso, atualize a referência no projeto para uma versão mais recente e compatível do Microsoft.Windows.SDK.BuildTools ou simplesmente remova a referência do deu projeto. Se você removê-la do seu projeto, uma versão compatível será implicitamente referenciada pelo pacote WinAppSDK.

  • No momento, a criação com o Arm64 Visual Studio não tem suporte.
  • Os padrões de inicializador automático da versão gratuita do WinRT desencaixada e com Bootstrapper são agora definidos apenas para projetos que produzem um executável (OutputType=Exe ou WinExe). Isso impede a adição de inicializadores automáticos em DLLs de biblioteca de classes e outros não executáveis por padrão.
    • Caso precise de um inicializador automático em um não executável (por exemplo, uma DLL de teste carregada por um executável genérico que não inicializa o Bootstrapper), você poderá habilitar explicitamente um inicializador automático em seu projeto por meio de <WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize> ou <WindowsAppSdkUndockedRegFreeWinRTInitialize>true</WindowsAppSdkUndockedRegFreeWinRTInitialize>.
  • As APIs de informações de versão (ReleaseInfo e RuntimeInfo) podem ser chamadas, mas retornam a versão 0 (não as informações de versão reais).

Versão 1.2 Preview 1 (1.2.0-preview1)

Em um SDK do Aplicativo Windows 1.1 existente (do canal estável), você pode atualizar seu pacote Nuget para 1.2.0-preview1 (confira a seção Atualizar um pacote em Instalar e gerenciar pacotes no Visual Studio usando o Gerenciador de Pacotes NuGet).

Para visualizar o runtime atualizado e o MSIX, confira Downloads mais recentes do SDK de Aplicativo do Windows.

WinUI 3

Os aplicativos da WinUI 3 podem reproduzir áudio e vídeo com os controles de reprodução de mídia MediaPlayerElement e MediaTransportControls. Para obter mais informações sobre como e quando usar os controles de mídia, confira Players de mídia.

A WinUI 3 foi atualizada com os controles, estilos e comportamentos mais recentes da WinUI 2.8. Essas atualizações incluem a adição do controle InfoBadge, melhorias na acessibilidade e no modo de alto contraste, bem como Correções de bugs nos controles. Para obter mais detalhes, confira as notas de versão para a WinUI 2.7 e WinUI 2.8.

Problema conhecido

ListView estilos regredidos e alterados do WinAppSDK 1.1.

Notificações

AppNotificationBuilder introduzido como uma alternativa ao conteúdo XML para criar e definir notificações de aplicativo.

Para obter informações de uso, confira a especificação do AppNotificationBuilder no GitHub.

Consulte também Início Rápido: notificações de aplicativo no SDK do Aplicativo Windows para obter um exemplo de como criar um aplicativo da área de trabalho do Windows que envia e recebe notificações de aplicativo local.

Alterações da falha

Para notificações por push, ao fazer uma chamada de solicitação de canal, os aplicativos precisarão usar a ID de Objeto do Azure em vez da ID do Aplicativo do Azure. Confira Início Rápido: notificação por push no SDK do Aplicativo Windows para obter detalhes sobre como localizar sua ID de Objeto do Azure.

Problema corrigido

O PushNotificationManager.IsSupported executará uma verificação para o modo elevado. Ele retornará false se o aplicativo for elevado.

Limitações conhecidas (Notificações)

Windowing

A personalização completa da barra de título agora está disponível no Windows 10, versão 1809 e posterior por meio da classe AppWindowTitleBar. Defina o AppWindowTitleBar.ExtendsContentIntoTitleBar como true para estender o conteúdo na área da barra de título e SetDragRectangles para definir regiões de arrastar (além de outras opções de personalização).

Caso esteja usando a propriedade AppWindowTitleBar.IsCustomizationSupported para verificar se você pode chamar as APIs AppWindowTitleBar, ela agora retornará true em versões do SDK do Aplicativo Windows para Windows 10 com suporte (1809 e posteriores).

Limitações conhecidas (janelas)

Não há suporte para personalizações simples da barra de título no Windows 10. Elas incluem Cor da tela de fundo, Cor da tela de fundo inativa, Cor do primeiro plano, Cor do primeiro plano inativo e Opções de exibição de ícone. Se chamar essas propriedades, elas serão ignoradas silenciosamente. Todas as outras APIs AppWindowTitleBar funcionam no Windows 10, versão 1809 e posteriores. Para as APIs de cores do botão de legenda (entre outras) e Altura, ExtendsContentIntoTitleBar devem ser definidas como true, caso contrário, elas também serão ignoradas silenciosamente.

Controle de acesso

Foi apresentado o security.accesscontrol.h com a função GetSecurityDescriptorForAppContainerNames para facilitar e simplificar o compartilhamento de objetos nomeados entre processos empacotados e as APIs gerais do Win32. Esse método usa uma lista de PFNs (Nomes de Família de Pacotes) e máscaras de acesso e retorna um descritor de segurança. Para obter mais informações, confira a especificação do GetSecurityDescriptorForAppContainerNames no GitHub.

Outras limitações e problemas conhecidos (1.2.0-preview1)

  • Não há suporte para PublishSingleFile do .NET.