MSIX em Windows 10 e Windows 11

O MSIX funciona em Windows 10 e Windows 11, mas nem todos os recursos estão disponíveis em ambos. Vários recursos foram introduzidos com o Windows 11 e não foram retrocompatibilizados, e alguns bugs do Windows 10 permanecem sem resolução. Esta página ajuda você a entender o que funciona onde, para que você possa tomar decisões de empacotamento informadas quando precisar dar suporte a Windows 10.

Comparação de recursos: Windows 10 versus Windows 11

A tabela a seguir compara a disponibilidade do recurso MSIX entre a versão mais recente do Windows 10 (22H2, que tem o mesmo suporte de recurso que 21H2) e Windows 11.

Para obter o detalhamento completo versão por versão de todas as versões do Windows 10, consulte Recursos MSIX e plataformas suportadas.

recursos exclusivos do Windows 11

Se o aplicativo usar qualquer um dos seguintes recursos, ele não funcionará no Windows 10:

Contêineres de pacote compartilhado

Os contêineres de pacote compartilhado permitem que vários aplicativos empacotados compartilhem um namespace de pacote comum, permitindo que eles compartilhem dados e configurações. Esse recurso requer Windows 11.

Alternativa ao Windows 10: Use um local de dados Win32 compartilhado (como %ProgramData% ou um pipe nomeado) fora do contêiner MSIX, ou você pode reestruturar os aplicativos como pacotes relacionados dentro de um único pacote.

Suporte ao menu de contexto herdado

Windows 11 introduziu suporte para registrar extensões do Shell empacotadas pelo MSIX (menus de contexto com o botão direito do mouse) que aparecem no menu de contexto clássico. Isso é relevante principalmente ao converter aplicativos ou programas desktop herdados para MSIX.

Windows 10 alternative: Use o PSF (Package Support Framework) ou forneça extensões de menu de contexto por meio de um instalador Win32 separado no Windows 10.

Diretórios de pacote mutável

Diretórios de pacote mutáveis permitem que os aplicativos escrevam em um subdiretório dentro do local de instalação, em vez do contêiner virtualizado. Requer Windows 11.

Windows 10 alternative: Gravar em ApplicationData.Current.LocalFolder (AppData\Local\Packages...\LocalState) ou em um local fora do pacote.

Identidade persistente do MSIX

A Identidade Persistente MSIX garante que a identidade do pacote de um aplicativo (nome da família, editor etc.) sobreviva à desinstalação e à reinstalação. Sem ele, os dados em LocalState são excluídos quando o aplicativo é desinstalado. É necessário Windows 11.

Windows 10 alternativa: armazenar dados persistentes fora do contêiner do pacote , por exemplo, em %APPDATA%, %LOCALAPPDATA% (fora da pasta Pacotes) ou um banco de dados em %ProgramData%.

Dependências dinâmicas

As dependências dinâmicas permitem que os aplicativos empacotados assumam dependências de runtime em pacotes de estrutura que não são declarados no tempo de empacotamento. Esse é o mecanismo subjacente ao suporte do SDK do Aplicativo Windows para aplicativos não empacotados. As APIs de dependência dinâmica do SDK do Aplicativo Windows (incluindo as APIs de Mdd* e o fluxo de bootstrapper) têm suporte tanto no Windows 10 quanto no Windows 11 onde o SDK do Aplicativo Windows é suportado. Uma implementação de dependência dinâmica nativa do sistema operacional separada também está disponível em Windows 11, versão 22H2 e posterior.

Windows 10 guidance: Use as APIs de dependência dinâmica do SDK do Aplicativo Windows ou o bootstrapper para lidar com a resolução de dependência no Windows 10 — nenhuma solução alternativa é necessária.

considerações específicas Windows 10

Política de instalação lateral

Geralmente, no Windows 10 versão 2004 e posterior, os pacotes MSIX assinados que não sejam da Loja podem ser instalados ao clicar duas vezes sem habilitar o sideload separadamente. Em versões mais antigas do Windows 10 (anteriores a 2004), o sideloading deve ser habilitado por meio do Modo de Desenvolvedor ou da Política de Grupo AllowAllTrustedApps.

As exceções se aplicam independentemente de Windows versão: pacotes não assinados exigem configuração de confiança adicional, e os dispositivos gerenciados pela empresa podem restringir ou desabilitar a instalação de aplicativos que não são da Store por meio da política.

No Windows 11, o sideloading também é habilitado por padrão para pacotes assinados de forma padrão, sujeitos às mesmas restrições estabelecidas por políticas.

Limitações de funcionalidades do LTSC 2021

Windows 10 LTSC 2021 (build 19044, equivalente a 20H2) falta recursos que foram adicionados no Windows 10 21H1 e posteriores:

Se a implantação empresarial for direcionada ao LTSC 2021, não dependerá da virtualização flexível ou dos grupos de menus de início empacotados.

Bugs não resolvidos no Windows 10

Alguns problemas MSIX relatados no Windows 10 não foram retroportados e é improvável que sejam corrigidos, dado que o Windows 10 atingiu o status de fim de suporte. Se você encontrar o comportamento MSIX no Windows 10 diferente do Windows 11, verifique os problemas abertos no repositório microsoft/msix-packaging.

As categorias comuns de problemas conhecidos Windows 10 específicos incluem:

• Casos extremos de virtualização do registro
• Confiabilidade do Instalador de Aplicativo com determinadas configurações de rede
• Compatibilidade da Ferramenta de Empacotamento com alguns tipos de instalador

Ferramentas de empacotamento para plataformas Windows 10

Se você estiver empacotando aplicativos para Windows 10 e encontrando problemas de compatibilidade de ferramentas, várias ferramentas de empacotamento da comunidade fornecem soluções alternativas de compatibilidade adicionais:

• MSIX Packaging Tool (Microsoft) — a ferramenta oficial; mantida ativamente
• Advanced Installer — ferramenta comercial com suporte forte Windows 10 MSIX e uma matriz de compatibilidade bem mantida
• Conveyor – ferramenta comunitária que automatiza o empacotamento para várias plataformas, incluindo o MSIX; útil se você também distribuir no macOS ou Linux

Essas ferramentas podem suavizar alguns casos extremos do Windows 10 no processo de compilação, embora as limitações do sistema operacional em tempo de execução (como a ausência de APIs exclusivas do Win11) não possam ser contornadas no processo de empacotamento.

Recomendação

Se você precisar dar suporte a Windows 10:

1. Evite recursos exclusivos do Windows 11 — não use contêineres de pacote compartilhado, diretórios de pacote mutáveis, identidade persistente ou dependências dinâmicas se seu MinVersion estiver direcionado para o Windows 10.
2. Defina um valor preciso para MinVersion no elemento TargetDeviceFamily do manifesto MSIX para o build mais antigo do Windows 10 que você pretende suportar.
3. Testes em Windows 10 especificamente — as diferenças de comportamento entre Windows 10 e Windows 11 raramente são identificadas em pipelines de CI que são exclusivos do Windows 11.
4. Planeje sua estratégia Win10 EOL — com o suporte mainstream do Windows 10 encerrado, considere definir um roteiro para exigir o Windows 11 em uma versão futura do aplicativo.

Conteúdo relacionado

• Recursos MSIX e Plataformas com Suporte – Tabela de Compatibilidade Versão por Versão Completa
• Escolha um caminho de distribuição para seu aplicativo Windows
• Status atual dos recursos de distribuição de aplicativos Windows
• Visão geral do Package Support Framework