Problemas conhecidos e dicas de solução de problemas para a Ferramenta de Empacotamento MSIX

Este artigo descreve os problemas conhecidos e fornece dicas de solução de problemas a serem considerados ao converter seus aplicativos em MSIX usando a Ferramenta de Empacotamento MSIX. Confira nossos outros documentos se você precisar adquirir a Ferramenta de Empacotamento MSIX ou o driver em ambientes desconectados.

Problemas conhecidos

Obter o build mais recente do Insider Preview da Ferramenta de Empacotamento MSIX

Se você tiver optado por nosso Programa Insider, certifique-se de ter a versão correta da Ferramenta de Empacotamento MSIX:

  • Vá para a seção Sobre na Ferramenta de Empacotamento MSIX para exibir em qual versão você está.
  • Acesse aqui para determinar a versão mais recente do Insider Preview e confirme se você tem essa versão da Ferramenta de Empacotamento MSIX instalada.
  • Certifique-se de que a MSA que está inscrevada para o voo seja a conta que está assinada no Microsoft Store.
  • Atualize manualmente a Ferramenta de Empacotamento MSIX por meio do Microsoft Store em seu computador. Se essa opção estiver disponível para você, abra a Loja, acesse Downloads e atualizações e clique em Obter atualizações. Como alternativa, pesquise a Ferramenta de Empacotamento MSIX e, na página do produto, você poderá solicitar uma atualização.
  • Para instalar a Ferramenta de Empacotamento MSIX para uso offline , siga estas instruções para garantir que você receba o aplicativo mais recente por meio de nosso processo offline.

Se você estiver interessado em ingressar em nosso Programa Insider, clique aqui.

Driver da Ferramenta de Empacotamento MSIX

O driver da Ferramenta de Empacotamento MSIX é entregue como um pacote FOD (recurso sob demanda) do Windows Update. Ele não será instalado se o serviço Windows Update estiver desabilitado no computador ou se Windows de anel de voo do Insider não corresponderem ao build do sistema operacional do computador.

Se você estiver com problemas para adquirir o driver ou estiver trabalhando em um ambiente offline, poderá encontrar links para baixar o driver aqui.

Se você baixou o driver e está com problemas durante a conversão do pacote, pode ser um dos problemas a seguir.

Problemas de conectividade de rede

Os seguintes códigos de erro podem indicar que você está encontrando problemas de conexão:

  • -2145107924 (0x8024402c)
  • -2145107945 (0x80244017)
  • -2145123272 (0x80240438)

Windows WSUS (Server Update Service), Configuration Manager ou políticas de grupo que afetam Windows Update conectividade

O código de erro a seguir pode indicar que as políticas em seu computador estão afetando Windows Update conectividade: -2145124306 (0x8024002e).

Se você receber esse código de erro, talvez seja necessário verificar as configurações e as políticas do ambiente.

O driver exigiu uma reinstalação

Nesse cenário, a Ferramenta de Empacotamento MSIX notificará você na mensagem de erro e os logs de que o driver precisa de uma reinicialização. Reinicie o computador e inicie a conversão novamente para corrigir esse problema.

Erro ao iniciar o driver da ferramenta de empacotamento MSIX 0x80131500

Se você receber esse erro durante a conversão, ao verificar o arquivo de log, deverá encontrar uma entrada como a seguinte:

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

Esse erro ocorre quando a ferramenta inicia uma nova sessão de rastreamento de eventos do sistema, mas você excedeu o número máximo de sessões que Windows pode criar em todo o sistema. Se você exceder o limite padrão (64), ocorrerá um erro ERROR_NO_SYSTEM_RESOURCES, o que faz com que o driver falhe.

A solução é interromper algumas das sessões de Rastreamento de Eventos existentes seguindo estas etapas:

  1. Abra o menu Iniciar e procure Monitor de Desempenho.
  2. Clique com o botão direito do mouse nele e escolha Mais –> Executar como Administrador.
  3. No menu de árvore, escolha Conjuntos de Coletores de Dados –> Sessões de Rastreamento de Eventos.
  4. Clique com o botão direito do mouse em algumas das sessões existentes na lista e escolha Parar.

Agora você pode tentar novamente executar a conversão com a Ferramenta de Empacotamento MSIX.

Versão mínima

Há alguns recursos a serem cientes de que alteram automaticamente o suporte à versão do minimonião em seu pacote MSIX.

Impor requisitos de controle de versão da Microsoft Store

Se você converter seu instalador existente usando uma versão da Ferramenta de Empacotamento MSIX anterior à 1.2019.701.0, a ferramenta tinha impor requisitos de controle de versão do Microsoft Store ou usou outra ferramenta para criar seu pacote que não definiu a versão mínima como 10.0.16299.0 (Windows 10, versão 1709). Isso causará uma mensagem de erro ao implantar seu aplicativo Windows 10 versão 1709 ou posterior.

Para corrigir esse problema, abra a Ferramenta de Empacotamento MSIX e edite seu aplicativo por meio do Editor de Pacotes. Abra o manifesto e de definido o MinVersion atributo do TargetDeviceFamily elemento como "10.0.16299.0".

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

MSIX com serviços

Na versão 1.2019.1220.0 da Ferramenta de Empacotamento MSIX, adicionamos suporte para criar um pacote MSIX com serviços. Devido às restrições do sistema operacional com suporte a serviços, a Ferramenta de Empacotamento MSIX altera automaticamente a versão mínima com suporte em um pacote MSIX com serviços para 10.0.19025.0. Isso significa que você não pode instalar um MSIX com serviços em um sistema operacional inferior ao Windows 10 versão 2004, mas pode criar esse MSIX usando a Ferramenta de Empacotamento MSIX até Windows 10 1809. Se você precisar instalar esse aplicativo em um sistema operacional inferior, atualize a versão mínima adequadamente, mas observe que o suporte para serviços não funcionará.

Estruturas e drivers

Se o aplicativo exigir uma estrutura, certifique-se de que a estrutura está instalada durante a fase de monitoramento da conversão. Acesse os logs para garantir que isso está acontecendo. Se seu aplicativo exigir que um driver seja instalado, você precisará avaliar se isso é necessário para que seu aplicativo seja executado corretamente. Atualmente, o MSIX não dá suporte à instalação do driver.

Computador remoto

Se você estiver com problemas com o uso de uma VM remota para suas conversões, consulte Instruções de instalação para conversões de computador remoto.

Problemas durante a conversão

  • Alguns instaladores podem falhar ao fazer a conversão com o código de saída 259. Isso indica que o instalador gerou um thread e não aguardou a conclusão dele. Em outras palavras, o thread principal concluiu a instalação, mas ele foi encerrado com o erro 259 porque gerou um thread que ainda está em execução. Recomendamos que você use a opção de instalação apropriada para setup.exe.

Problemas durante a assinatura

Certificado PE defeituoso (0x800700C1)

Esse problema ocorre quando o pacote contém um arquivo binário que tem um certificado corrompido. Para resolver esse problema, use o comando dumpbin.exe /headers para despejar os headers de arquivo e inspecionar elementos ruins. Reescreva manualmente os títulos para corrigir o problema. Em geral, a ferramenta empacotamento MSIX detecta automaticamente os headers ruins. Se esse problema persistir, arquivar comentários. Encontre mais informações aqui.

Autenticação do Device Guard

Siga estas etapas e se você está atribuindo as funções apropriadas no Microsoft Store para Empresas.

Certificado expirado

  • Use um data/hora ao assinar o pacote.
  • Você pode se retirar com um certificado de sinal ou de data/hora válido.

Você pode abandonar seu aplicativo usando o script de conversão em lote.

Solução de problemas

Arquivos de log

Independentemente de a conversão ter sido bem-sucedida ou não, os arquivos de log são gerados para cada conversão. Eles podem ser encontrados aqui:

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

Os códigos de falha são escritos e indicam qualquer ponto de falha durante o processo de conversão. Os códigos de erro destinam-se a ser amigáveis.

Arquivos de log de dispositivos remotos ou VMs

Se a conversão for executada em um dispositivo remoto ou uma VM, recomendaremos que você copie os arquivos de log desse dispositivo e anexe-os como parte do item de comentário. Isso nos ajudará a diagnosticar e resolver problemas com mais eficiência.

Você encontrará os logs das conversões remotas aqui: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Seria ainda mais útil se você pudesse compartilhar toda a pasta Logs que incluirá as operações que ocorrem no cliente local, bem como o servidor remoto.

Problemas comuns

Erros de conversão de MakePri/Manifesto

Esse erro ocorre quando há um problema com o manifesto do pacote. Para identificar o problema, vá para Editor de Pacotes e abra o manifesto. Ao abrir o manifesto, você pode identificar o problema e fornecer a correção adequada.

Arquivo não encontrado

O arquivo pode ser aberto ou inexistente. Para resolver esse problema, adicione o arquivo apropriado ou feche o arquivo que está em uso no momento. Observe que você não receberá um File not Found erro se ele estiver aberto. Em vez disso, você receberá um Access Denied erro ou File in Use .

Associações de tipo de arquivo

Os problemas relacionados a FTAS (associações de tipo de arquivo) variam de pacote para pacote. A ferramenta de empacotamento MSIX dá suporte a associações de arquivo para instalações de clique duplo. Por exemplo, se seu aplicativo tiver um menu de contexto, ele não será adicionado automaticamente, portanto, será necessário adicioná-lo manualmente ao manifesto. Consulte o elemento manifesto desktop4: FileExplorerContextMenus para obter um exemplo.

Atalhos com argumentos

Atualmente, não há suporte para atalhos com argumentos com MSIX. Se detectarmos que o instalador inclui isso, o MSIX criará um bloco sem argumentos.

Diretório de instalação

Isso é mais comum para aqueles que usam uma unidade secundária para executar conversões de aplicativo. Se você optar por alterar o local de instalação, ele alterará a raiz de onde todos os arquivos vão. Isso significa que a ferramenta de empacotamento MSIX precisará saber onde todos esses arquivos vão e serão capturados durante a conversão.

Você pode corrigir isso usando a gravação da estrutura de suporte do pacote para instalar a correção do diretório. Adicionamos isso como um recurso por padrão na ferramenta MSIX, que permite isso até 1809. Se seu aplicativo não estiver funcionando no 1709 e estiver em 1809, isso provavelmente será o problema.

Como enviar comentários

A melhor maneira de enviar seus comentários é por meio do Hub de comentários.

  1. Abra o Hub de Feedback ou digite Windows + F.
  2. Forneça um título e as etapas necessárias para reproduzir o problema.
  3. Em Categoria, selecione Aplicativos e selecione Ferramenta de Empacotamento MSIX.
  4. Anexe os arquivos de log associados à conversão. Encontre os logs na pasta fornecida acima.
  5. Anexe o pacote MSIX convertido (se possível).
  6. Clique em Enviar.

Envie-nos também comentários diretamente da Ferramenta de Empacotamento MSIX acessando a guia Comentários em Configurações.

Observação

Poderá levar 24 horas até recebermos seus comentários. Portanto, se você estiver usando uma VM para converter o pacote, o ideal será manter a VM ligada e em seu estado atual durante 24 horas após a conversão. Além disso, você pode anexar manualmente os logs de conversão aos comentários.