Compartilhar via

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

  • 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.1 Preview 3 (1.1.0-preview3)

Esta é a versão mais recente do canal de preview para a versão 1.1. Ela oferece suporte a todos os recursos do canal de preview (confira Recursos disponíveis por canal de lançamento).

Em um aplicativo existente que usa o SDK do Aplicativo Windows 1.0, você pode atualizar seu pacote Nuget para 1.1.0-preview3 (confira a seção Atualizar um pacote em Instalar e gerenciar pacotes no Visual Studio usando o Gerenciador de Pacotes NuGet). Além disso, confira Downloads mais recentes do SDK do Aplicativo Windows para obter o runtime atualizado e o MSIX.

Observação

Para desenvolvedores do C#, uma das seguintes versões do SDK do .NET (ou posterior) é necessária: 6.0.202, 6.0.104, 5.0.407 e 5.0.213. Para atualizar sua versão do SDK do .NET, visite os Downloads do .NET ou atualize para a última versão do Visual Studio. Sem a versão necessária do SDK do .NET, ao atualizar o pacote NuGet, você visualizará um erro como: "Esta versão do WindowsAppSDK requer o WinRT.Runtime.dll versão 1.6 ou superior".

Além de todos os recursos do Preview 2, as seções a seguir descrevem recursos novos e atualizados, limitações e problemas conhecidos desta versão.

WinUI 3 (1.1.0-preview3)

Mica e plano de fundo acrílico agora estão disponíveis para aplicativos da WinUI 3.

Para obter mais informações sobre esses materiais, confira os Materiais em Windows 11. Confira nosso código de exemplo para aplicar Mica em aplicativos C++ em Aplicar materiais Mica ou Acrylic em aplicativos para área de trabalho para Windows 11 e em aplicativos C# no GitHub como parte da Galeria de Controles WinUI.

Notificações (1.1.0-preview3)

Problemas corrigidos:

  • Na 1.1.0-preview1 e 1.1.0-preview2, alguns aplicativos não empacotados terão visto seus ícones de aplicativo copiados incorretamente para AppData\LocalMicrosoftWindowsAppSDK. Para esta versão, eles serão copiados para AppData\Local\Microsoft\WindowsAppSDK. Para evitar o vazamento de ícones, você deve excluir manualmente o ícone do aplicativo no caminho incorreto após atualizar para a visualização 1.1.0-preview3.
  • O ícone do aplicativo e a recuperação do nome de exibição do aplicativo para notificações do aplicativo por meio de Atalhos agora são suportados. Este ícone de aplicativo será priorizado sobre qualquer ícone especificado em arquivos de recursos.
  • O suporte para notificações por push para aplicativos não empacotados foi restaurado (confira Limitações para exceções observadas). Introduzimos a API PushNotificationManager::IsSupported para verificar se seu aplicativo oferece suporte a notificações por push.

Limitações:

  • Não há suporte para um aplicativo não empacotado elevado. O PushNotificationManager::IsSupported não executará uma verificação para o modo elevado. No entanto, estamos trabalhando para oferecer suporte a isso em uma versão futura.

Empacotamento MSIX

Aprimoramos o MSIX adicionando funcionalidades novas e ampliando as existentes por meio das categorias de extensão:

  • windows.appExecutionAlias
  • windows.customDesktopEventLog
  • windows.dataShortcuts
  • windows.fileTypeAssociation
  • windows.fileTypeAssociation.iconHandler
  • windows.folder
  • windows.shortcut

Eles exigem que o pacote de estrutura de SDK do Aplicativo Windows seja instalado. Confira Downloads mais recentes do SDK do Aplicativo Windows para instalar o runtime.

Gerenciador de ambientes (1.1.0-preview3)

Conjunto de APIs que permite aos desenvolvedores adicionar, remover e modificar variáveis de ambiente sem precisar usar diretamente a API do Registro.

Esclarecimento da 1.1 Preview 1: A remoção automática de qualquer alteração de variável de ambiente quando um aplicativo que usou o gerenciador de ambiente é desinstalado só está disponível para aplicativos empacotados. Além disso, reverter alterações de variáveis de ambiente requer a instalação do pacote de estrutura do SDK do Aplicativo Windows, confira Downloads mais recentes do SDK do Aplicativo Windows para o runtime.

Outras limitações conhecidas

Regressões do 1.1 Preview 2:

  • Para aplicativos .NET que usam APIs MRT Core e aplicativos WinUI que não são implantados com MSIX de projeto único:
    • Os arquivos RESW e de imagem que foram adicionados ao projeto como Itens Existentes e anteriormente incluídos automaticamente no PRIResource e no Content ItemGroups, respectivamente, não serão incluídos nesses ItemGroups. Como resultado, esses recursos não serão indexados durante a geração do PRI, portanto, não estarão disponíveis durante o runtime.
      • Solução alternativa: inclua manualmente os recursos no arquivo de projeto e remova-os do None ItemGroup.
      • Solução alternativa: quando disponível, atualize o SDK do .NET de seus aplicativos para 6.0.300. Consulte Requisitos de versão do SDK do .NET para obter informações adicionais.
  • Para aplicativos .NET que não são implantados com MSIX de projeto único:
    • Se um arquivo for adicionado ao Content ItemGroup duas vezes ou mais, haverá um erro de build.
      • Solução alternativa: exclua a(s) inclusão(ões) duplicata(s) ou defina EnableDefaultContentItems como false no arquivo de projeto.

Ambas as regressões serão restauradas na próxima versão estável.

Versão 1.1 Preview 2 (1.1.0-preview2)

Esta é a segunda versão do canal de preview para a versão 1.1. Ela oferece suporte a todos os recursos do canal de preview (confira Recursos disponíveis por canal de lançamento).

Em um aplicativo existente que usa o SDK do Aplicativo Windows 1.0, você pode atualizar seu pacote Nuget para 1.1.0-preview2 (confira a seção Atualizar um pacote em Instalar e gerenciar pacotes no Visual Studio usando o Gerenciador de Pacotes NuGet). Além disso, confira Downloads mais recentes do SDK do Aplicativo Windows para obter o runtime atualizado e o MSIX.

Observação

Para desenvolvedores do C#, uma das seguintes versões do SDK do .NET (ou posterior) é necessária: 6.0.202, 6.0.104, 5.0.407 e 5.0.213. Para atualizar sua versão do SDK do .NET, visite os Downloads do .NET ou atualize para a última versão do Visual Studio. Sem a versão necessária do SDK do .NET, ao atualizar o pacote NuGet, você visualizará um erro como: "Esta versão do WindowsAppSDK requer o WinRT.Runtime.dll versão 1.6 ou superior".

Além de todos os recursos do Preview 1, as seções a seguir descrevem recursos novos e atualizados, limitações e problemas conhecidos desta versão.

Notificações (1.1.0-preview2)

Problemas corrigidos:

  • Um aplicativo sem identificador de pacote enviando notificações agora verá seu ícone de aplicativo na notificação se o ícone fizer parte do recurso do aplicativo. Se o recurso do aplicativo não tiver ícone, o ícone do aplicativo padrão do Windows será usado.
  • Um aplicativo WinUI 3 que não está em execução agora pode ser ativado em segundo plano por meio de uma notificação.

Regressão da 1.1 Preview 1: suporte a notificações por push para aplicativos não empacotados. Espera-se que seja restaurado na próxima versão.

Limitações conhecidas:

  • Introduzimos a API PushNotificationManager::IsSupported para verificar se os aplicativos independentes oferecem suporte a notificações por push. No entanto, essa API ainda não está funcionando como esperado, portanto, fique de olho na próxima versão de preview para obter suporte total da API IsSupported.
  • Alguns aplicativos não empacotados verão seus ícones de aplicativo copiados incorretamente para AppData\LocalMicrosoftWindowsAppSDK. Para a próxima versão, eles serão copiados para AppData\Local\Microsoft\WindowsAppSDK. Para evitar o vazamento de ícones, o desenvolvedor deve excluir manualmente o ícone do aplicativo no caminho incorreto após a atualização para a próxima versão.
  • Não há suporte para a recuperação de ícone e nome de exibição do aplicativo para notificações via Atalhos. Mas estamos trabalhando para apoiar isso em um lançamento futuro.

Implantação

Novos recursos:

Limitações conhecidas:

  • Há suporte para a implantação independente apenas no Windows 10, 1903 e posterior.

Janelas

Para facilitar o acesso de programação à funcionalidade implementada no USER32.dll (confira Windows e mensagens), esta versão apresenta mais dessa funcionalidade no próprio AppWindow.

Novos recursos:

  • Os aplicativos com janelas existentes têm mais controle sobre como uma janela é mostrada, chamando AppWindow.ShowOnceWithRequestedStartupState— o equivalente a ShowWindow(SW_SHOWDEFAULT).
  • Os aplicativos podem mostrar, minimizar ou restaurar uma janela e especificar se a janela deve ser ativada ou não no momento em que a chamada é feita.
  • Os aplicativos agora podem definir o tamanho da área de cliente de uma janela em coordenadas Win32.
  • Adicionamos APIs para dar suporte ao gerenciamento de ordens z de janelas.
  • Os aplicativos que desenham barras de título personalizadas com AppWindowTitleBar.ExtendsContentIntoTitleBar podem definir uma opção PreferredTitleBarHeight. Você pode escolher entre uma barra de título de altura standard ou uma barra de título alta que oferece mais espaço para conteúdo interativo. Confira Barra de título nas diretrizes do Fluent Design para obter conselhos sobre quando usar uma barra de título alta.

Limitações conhecidas:

  • O suporte à barra de título alta está disponível apenas no Windows 11. Estamos trabalhando para reduzir essa API de versão anterior junto com outras APIs personalizadas da barra de título.

WinUI 3 (1.1.0-preview2)

Problemas corrigidos:

  • Corrigido o problema que fazia com que aplicativos C# com WebView2 falhassem na inicialização quando o CRT (Runtime do C/C++) não estava instalado atualizando o SDK do WebView2 de 1020.46 para 1185.39.
  • Corrigido o problema que fazia com que alguns cantos arredondados mostrassem um gradiente quando deveriam ser uma cor sólida. Para obter mais informações, confira os issues n.º 6076 e n.º 6194 no GitHub.
  • Corrigido o problema em que os estilos atualizados estavam ausentes de generic.xaml.
  • Correção do problema de ciclo de layout que fazia com que um aplicativo falhasse ao rolar até o final de um ListView. Para obter mais informações, confira o issue n.º 6218 no GitHub.

Desempenho

Os aplicativos C# têm várias melhorias de desempenho. Confira as notas sobre a versão C#/WinRT 1.6.1 para obter mais detalhes.

Versão 1.1 Preview 1 (1.1.0-preview1)

Esta é a primeira versão do canal de preview para a versão 1.1. Ela oferece suporte a todos os recursos do canal de preview (confira Recursos disponíveis por canal de lançamento).

Em um aplicativo existente que usa o SDK do Aplicativo Windows 1.0, você pode atualizar seu pacote Nuget para 1.1.0-preview1 (confira a seção Atualizar um pacote em Instalar e gerenciar pacotes no Visual Studio usando o Gerenciador de Pacotes NuGet). Além disso, confira Downloads mais recentes do SDK do Aplicativo Windows para obter o runtime atualizado e o MSIX.

As seções a seguir descrevem os recursos novos e atualizados, as limitações e os problemas conhecidos para essa versão.

WinUI 3 (1.1.0-preview1)

Issue conhecido: os usuários não conseguem descartar um elemento quando o recurso arrastar e soltar está habilitado.

Suporte elevado (admin)

Usando o SDK do Aplicativo Windows 1.1 Preview 1, os aplicativos (incluindo o WinUI 3) poderão ser executados com privilégios elevados.

Limitações importantes:

  • No momento, disponível apenas no Windows 11. Mas estamos avaliando reduzir esse nível de suporte em uma versão posterior.

Problemas conhecidos:

  • Os aplicativos WinUI 3 travam ao arrastar um elemento durante uma interação de arrastar e soltar.

Implantação autocontida

O SDK do Aplicativo Windows 1.1 apresentará suporte para implantação independente. Nossa Visão geral da implantação do SDK do Aplicativo Windows detalha as diferenças entre a implantação dependente da estrutura e a implantação independente e como começar.

Problemas conhecidos:

  • Um aplicativo C++ empacotado precisa adicionar o abaixo à parte inferior de seu arquivo de projeto para contornar um bug no arquivo autocontido .targets que remove referências de estrutura para VCLibs:

    <PropertyGroup>
    <IncludeGetResolvedSDKReferences>true</IncludeGetResolvedSDKReferences>
</PropertyGroup>

<Target Name="_RemoveFrameworkReferences"
    BeforeTargets="_ConvertItems;_CalculateInputsForGenerateCurrentProjectAppxManifest">
    <ItemGroup>
        <FrameworkSdkReference Remove="@(FrameworkSdkReference)" Condition="'%(FrameworkSdkReference.SDKName)' == 'Microsoft.WindowsAppRuntime.1.1-preview1'" />
    </ItemGroup>
</Target>

  • Com suporte apenas no Windows 10, 1903 e posterior.

Notificações (1.1.0-preview1)

Os desenvolvedores de aplicativos empacotados (incluindo empacotados com localização externa) e aplicativos não empacotados agora podem enviar notificações do Windows.

Novos recursos:

  • Suporte para notificações de aplicativo para aplicativos empacotados e não empacotados. Detalhes completos sobre o GitHub
    • Os desenvolvedores podem enviar notificações de aplicativo, também conhecidas como notificações do sistema, localmente ou de seu próprio serviço de nuvem.
  • Suporte para notificação por push para aplicativos empacotados e não empacotados. Detalhes completos sobre o GitHub
    • Os desenvolvedores podem enviar notificações brutas ou notificações de aplicativos do seu próprio serviço de nuvem.

Limitações:

  • Os aplicativos publicados como independentes podem não ter suporte a notificações por push. Fique de olho na próxima versão de preview de uma API IsSupported para verificar se há suporte a notificações por push.
  • Os aplicativos que não são empacotados enviando notificações de aplicativo não verão o ícone do aplicativo na notificação do aplicativo, a menos que sejam aplicativos de console. Os aplicativos de console que não são empacotados devem seguir os padrões mostrados no exemplo ToastNotificationsDemoApp.
  • O runtime do SDK do Aplicativo Windows deve ser instalado para oferecer suporte a notificações por push. Confira Downloads mais recentes do SDK do Aplicativo Windows para o instalador.
  • Um aplicativo WinUI 3 que não está em execução não pode ser ativado em segundo plano por meio de uma notificação. Mas estamos trabalhando para apoiar isso em um lançamento futuro.

Gerenciador de ambientes (1.1.0-preview1)

Conjunto de APIs que permite aos desenvolvedores adicionar, remover e modificar variáveis de ambiente sem precisar usar diretamente a API do Registro.

Novos recursos:

  • Fornece a remoção automática de quaisquer alterações de variáveis de ambiente quando um aplicativo que usava o gerenciador de ambiente é desinstalado.

Limitações:

  • Atualmente indisponível em aplicativos C#. Mas estamos avaliando trazer esse recurso para aplicativos C# em uma versão posterior.

Outras limitações e problemas conhecidos

  • Se você estiver usando C# com 1.1.0 Preview 1, deverá usar uma das seguintes versões do SDK do .NET no mínimo: .NET SDK 6.0.201, 6.0.103, 5.0.212 ou 5.0.406. Para atualizar seu SDK do .NET, você pode atualizar para a última versão do Visual Studio ou visitar Download .NET.