Notas sobre a versão do canal experimental para o SDK do Aplicativo Windows 1.0
Importante
O canal experimental não é compatível com o uso em ambientes de produção e os aplicativos que usam as versões experimentais não podem ser publicados na Microsoft Store.
O canal experimental fornece versões do SDK do Aplicativo Windows que incluem recursos experimentais do canal que estão em estágios iniciais de desenvolvimento. As APIs para recursos experimentais têm o atributo Experimental. Caso chame uma API experimental em seu código, você receberá um aviso no tempo de compilação. Todas as APIs no canal experimental podem ter alterações interruptivas em versões futuras, mas as APIs experimentais estão especialmente sujeitas a alterações. Os recursos experimentais podem ser removidos da próxima versão ou podem nunca ser lançados.
Links importantes:
- Caso queira atualizar um aplicativo existente de uma versão mais antiga do SDK do Aplicativo Windows para uma versão mais recente, confira Atualizar projetos existentes para a versão mais recente do SDK do Aplicativo Windows.
- Para obter documentação sobre versões experimentais, confira Instalar ferramentas para preview e canais experimentais do SDK do Aplicativo Windows.
Versão mais recente do canal experimental:
Versão de canal estável mais recente:
Versão 1.0 Experimental (1.0.0-experimental1)
Esta versão é compatível com todos os recursos do canal experimental.
As seções a seguir descrevem os recursos novos e atualizados, as limitações e os problemas conhecidos para essa versão.
WinUI 3
Essa versão do WinUI 3 é focada na construção de novos recursos para 1.0 estável e correção de bugs.
- Novos recursos: suporte para mostrar um ContentDialog por janela em vez de por thread.
- Para obter a lista completa dos bugs abordados nessa versão, confira nosso repositório GitHub.
- Amostras: para visualizar os controles e recursos do WinUI 3 em ação, clone e crie a Galeria de aplicativo do WinUI 3 do GitHub ou baixe o aplicativo na Microsoft Store.
Para obter mais informações ou para começar a desenvolver com o WinUI, confira:
Notificações por push (recurso experimental)
Esta versão apresenta uma API de notificações por push que pode ser usada por aplicativos para desktop empacotados com identidades baseadas no registro de aplicativo do Azure. Para usar esse recurso, crie uma conta em nossa versão prévia privada.
Limitações importantes:
- As notificações por push só têm suporte em aplicativos empacotados do MSIX em execução no Windows 10 versão 2004 (build 19041) ou posteriores.
- A Microsoft se reserva o direito de desabilitar ou revogar aplicativos de notificações por push durante a versão prévia privada.
- A Microsoft não garante a confiabilidade ou a latência de notificações por push.
- Durante a versão prévia privada, o volume de notificações por push é limitado a 1 milhão por mês.
Para obter mais informações, consulte Visão geral das notificações por push.
Janelas
Essa versão inclui atualizações para as APIs de janelas. Trata-se de um conjunto de APIs de janelas de alto nível, centradas na classe AppWindow, que permite cenários de janelas fáceis de usar que se integram bem à experiência do usuário do Windows e de outros aplicativos. Isso é semelhante, mas não igual, ao UWP AppWindow.
Limitações importantes:
- Essa versão do
AppWindow
está atualmente disponível apenas para aplicativos Win32 (empacotados e não empacotados). - No momento, o SDK do Aplicativo Windows não fornece métodos para anexar conteúdo da estrutura da IU a um
AppWindow
; você está limitado a usar os métodos de acesso interop doHWND
. - No momento, as APIs de janelas não funcionarão no Windows versão 1809 e 1903 para AMD64.
Para obter mais informações, confira Gerenciar janelas de aplicativos (SDK do Aplicativo Windows).
Implantação para aplicativos não empacotados
Essa versão introduz atualizações para o recurso de dependências dinâmicas, incluindo a API do bootstrapper.
Limitações importantes:
- O recurso de dependências dinâmicas só é compatível com aplicativos não empacotados.
- Não há suporte para chamadores elevados.
Para obter mais informações, consulte os seguintes artigos:
- Pacotes de estrutura MSIX e dependências dinâmicas
- Usar o runtime do SDK do Aplicativo Windows para aplicativos empacotados com localização externa ou não empacotado
Outras limitações e problemas conhecidos
- Não há suporte para qualquer configuração da compilação de CPU: o SDK do Aplicativo Windows é escrito em código nativo e, portanto, não oferece suporte para qualquer configuração da compilação de CPU. Os modelos do WinUI 3 no Visual Studio só permitem compilações específicas da arquitetura. Ao adicionar o SDK do Aplicativo Windows a um aplicativo ou componente do .NET existente que seja compatível com qualquer CPU, especifique a arquitetura desejada:
x86
,x64
ouarm64
. - Os aplicativos do .NET devem ter como destino o build 18362 ou posterior: o TFM deve ser definido como
net6.0-windows10.0.18362
ou posterior e o projeto de empacotamento<TargetPlatformVersion>
deve ser definido como 18362 ou posterior. Para obter mais informações, confira o issue conhecido no GitHub. - Os aplicativos C# que usam o 1.0 Experimental devem usar um dos seguintes SDKs do .NET:
- SDK do .NET 6 ou posterior (confira Fazer download de .NET e .NET 5 chegará ao fim do suporte em 10 de maio de 2022).
Tópicos relacionados
- Notas sobre a versão de canal estável mais recente para o SDK de Aplicativo do Windows
- Notas sobre a versão mais recente do canal de pré-visualização para o SDK de Aplicativo do Windows
- Instalar ferramentas para o SDK do Aplicativo Windows
- Criar seu primeiro projeto WinUI 3 (SDK do Aplicativo Windows)
- Usar o SDK do Aplicativo do Windows em um projeto existente
- Visão geral da implantação
Windows developer