Conheça seu instalador

Este artigo lista as coisas que você precisa saber antes de converter seu instalador existente em um MSIX. Talvez você não precise fazer muito para preparar seu aplicativo para o processo de empacotamento, mas se qualquer um dos itens abaixo se aplicar ao seu aplicativo, precisará resolvê-lo antes do empacotamento.

• Seu aplicativo tem um serviço. Damos suporte à conversão de aplicativos com serviços, mas é importante ter em mente as limitações para converter um serviço. Após a conversão, você precisará da elevação do administrador para instalar o MSIX que contém um serviço. Você pode converter um aplicativo com serviços a partir da versão 1.2019.1220.0 da Ferramenta de Empacotamento de MSIX e implantar o MSIX com serviços a partir da versão Spring 2020 do Windows 10.

• O instalador requer uma reinicialização. Se o instalador exigir uma reinicialização, isso terá suporte na Ferramenta de Empacotamento MSIX a partir da versão 1.2019.701.0. Se o instalador retornar um código de saída incomum para indicar que precisa de uma reinicialização, você deverá adicioná-lo à seção de códigos de saída de reinicialização das configurações da Ferramenta de Empacotamento MSIX.

• Seu aplicativo .NET requer uma versão do .NET Framework anterior à 4.6.2. Se você estiver empacotando um aplicativo .NET, recomendamos que seu aplicativo tenha como destino o .NET Framework 4.6.2 ou posterior. A capacidade de instalar e executar aplicativos de área de trabalho empacotados foi introduzida pela primeira vez no Windows 10, versão 1607 (também chamada de Atualização de Aniversário), e essa versão do sistema operacional inclui o .NET Framework 4.6.2 por padrão. Versões posteriores do sistema operacional incluem versões posteriores do .NET Framework. Para obter uma lista completa de quais versões do .NET estão incluídas em versões posteriores do Windows 10, consulte este artigo.

  Espera-se que usar versões do .NET Framework anteriores à 4.6.2 em aplicativos de desktop empacotados tenha sucesso na maioria dos casos. No entanto, se você escolher uma versão anterior à 4.6.2 como destino, deverá testá-la por completo no aplicativo da área de trabalho empacotado antes da distribuição para os usuários.

  • 4.0 – 4.6.1: os aplicativos destinados a essas versões do .NET Framework devem ser executados sem problemas na 4.6.2 ou posterior. Portanto, esses aplicativos devem instalar e executar sem alterações no Windows 10, versão 1607 ou posterior com a versão do .NET Framework incluída no sistema operacional.

  • 2.0 e 3.5: em nossos testes, os aplicativos de área de trabalho empacotados destinados a essas versões do .NET Framework geralmente funcionam, mas podem apresentar problemas de desempenho em alguns cenários. Para que esses aplicativos empacotados sejam instalados e executados, o recurso .NET Framework 3.5 deve ser instalado no computador de destino (esse recurso também inclui o .NET Framework 2.0 e 3.0). Você também deve testar esses aplicativos completamente depois de empacotá-los.

• Seu aplicativo requer um driver. O MSIX não dá suporte a drivers.

• Seu aplicativo grava na pasta AppData ou no registro com a intenção de compartilhar dados com outro aplicativo. Após a conversão, AppData é redirecionado para o repositório de dados do aplicativo local, que é um repositório privado para cada aplicativo.

  Todas as entradas que seu aplicativo grava no hive do registro HKEY_LOCAL_MACHINE são redirecionadas para um arquivo binário isolado e todas as entradas que seu aplicativo grava no hive do registro HKEY_CURRENT_USER são colocadas em um local privado por usuário por aplicativo. Para obter mais detalhes sobre o redirecionamento de arquivo e Registro, veja Bastidores da Ponte de Desktop.

• O aplicativo faz a gravação no diretório de instalação do aplicativo. Por exemplo, seu aplicativo grava em um arquivo de log que você coloca no mesmo diretório que seu exe. Não há suporte para isso porque a pasta está protegida. Recomendamos gravar em outro local, como o repositório de dados do aplicativo local. Adicionamos um recurso que permite isso na versão 1809 e nas seguintes.

• Seu aplicativo usa o diretório de trabalho atual. Em runtime, o aplicativo da área de trabalho empacotado não terá o mesmo diretório de trabalho especificado anteriormente no atalho .LNK da área de trabalho. Você precisa alterar seu CWD em runtime se ter o diretório correto é importante para que seu aplicativo funcione corretamente.

• Seu aplicativo instala e carrega assemblies do diretório side-by-side do Windows. Por exemplo, seu aplicativo usa bibliotecas de runtime C VC8 ou VC9 e as vincula dinamicamente da pasta lado a lado do Windows, o que significa que seu código está usando os arquivos DLL comuns de uma pasta compartilhada, como C:\Windows\WinSxS. Isso não tem suporte. Você precisará vinculá-los estaticamente vinculando-os aos arquivos de biblioteca redistribuíveis diretamente em seu código.

Outras considerações

• Reempacotando seu instalador na arquitetura adequada. Se o instalador tiver a intenção de ser instalado em um computador x86. Certifique-se de reempacotar o instalador em um computador x86. Isso é aplicável ao instalador destinado a computadores x64.

  Observação

  Caso o aplicativo precise ser gravado no diretório de instalação ou usar o diretório de trabalho atual, considere também a possibilidade de adicionar uma correção de runtime usando o Package Support Framework do pacote. Para obter mais detalhes, confira este artigo.