Compartilhar via

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

Este artigo descreve problemas conhecidos e fornece dicas de solução de problemas a serem consideradas 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

Obtendo a versão mais recente do Insider Preview da Ferramenta de Empacotamento MSIX

Se você optou pelo programa Insider, verifique se tem 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.
  • Verifique se a MSA que está inscrita para o teste das versões de pré-lançamento é a conta que está assinada na Microsoft Store.
  • Atualize manualmente a Ferramenta de Empacotamento MSIX por meio da Microsoft Store em seu computador. Se essa opção estiver disponível para você, abra a Loja, vá para 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ê pode solicitar uma atualização.
  • Para instalar a Ferramenta de Empacotamento MSIX para uso offline, siga estas instruções para garantir que você obtenha o aplicativo mais recente por meio do nosso processo offline.

Se você estiver interessado em ingressar em nosso Programa Insider, acesse Ingressar no Insider da Ferramenta de Empacotamento MSIX!.

Driver da Ferramenta de Empacotamento de 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 as configurações do anel de pré-lançamento do Windows Insider não corresponderem à versão do sistema operacional do computador.

Se você estiver tendo 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 seguintes problemas.

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)

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

O código de erro a seguir pode indicar que as políticas em seu computador estão afetando a conectividade do Windows Update: -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 precisou de uma reinstalação

Nesse cenário, a Ferramenta de Empacotamento MSIX notificará você na mensagem de erro e nos 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 o Windows pode criar em todo o sistema. Se você exceder o limite padrão (64), você atingirá um erro ERROR_NO_SYSTEM_RESOURCES, o que fará 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 o 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 executar novamente a conversão com a Ferramenta de Empacotamento MSIX.

Versão mínima

Existem alguns recursos dos quais você deve estar ciente que mudam automaticamente a versão mínima de suporte no seu pacote MSIX.

Impor requisitos de controle de versão da Microsoft Store

Se você converter o instalador existente usando uma versão da Ferramenta de Empacotamento de MSIX anterior à 1.2019.701.0, isso indicará que a ferramenta tinha a configuração Impor os requisitos de controle de versão da Microsoft Store ou usou outra ferramenta para criar o 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 no Windows 10, versão 1709 ou uma versão 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 defina 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é o 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 controladores

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

Computador Remoto

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

Problemas durante a conversão

  • Alguns instaladores podem falhar ao converter com o código de saída 259. Isso indica que o instalador gerou um thread e não esperou que ele fosse concluído. Em outras palavras, o thread principal terminou de ser instalado, mas saiu 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 inválido (0x800700C1)

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

Assinatura do Device Guard

Certifique-se de seguir estas etapas e de atribuir as funções apropriadas na Microsoft Store para Empresas.

Certificado expirado

  • Use um carimbo de data/hora ao assinar o pacote.
  • Você pode fazer a assinatura novamente com um certificado de assinatura ou carimbo de data/hora válido.

Você pode renunciar ao aplicativo usando o script de conversão em lote no MSIX Toolkit – Scripts.

Resolução de problemas

Arquivos de log

Se a conversão foi ou não bem-sucedida, 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 gravados e indicam qualquer ponto de falha durante o processo de conversão. Os códigos de erro devem ser amigáveis para o usuário.

Arquivos de log de dispositivos remotos ou VMs

Se a conversão for executada em um dispositivo remoto ou em uma VM, recomendamos que você copie os arquivos de log desse dispositivo e os anexe como parte do item de comentários. 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 benéfico se você puder 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 MakePri/Manifest

Esse erro ocorre quando há um problema com o manifesto do pacote. Para identificar o problema, acesse o 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 estar 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 ou File in Use erro.

Associações de tipo de arquivo

Os problemas relacionados às FTA (Associações de Tipo de Arquivo) variam de pacote para pacote. A Ferramenta de Empacotamento MSIX dá suporte a associações de arquivos para instalações de clique duplo. Por exemplo, se seu aplicativo tiver menu de contexto, ele não será adicionado automaticamente, portanto, você precisará adicioná-lo manualmente ao manifesto. Consulte o elemento de manifesto desktop4:FileExplorerContextMenus para obter um exemplo.

Atalhos com argumentos

A ferramenta Empacotamento de MSIX vai capturar todos os atalhos de nível de usuário junto com argumentos. Caso esses atalhos não sejam detectados corretamente, você poderá adicioná-los manualmente ao manifesto. Consulte desktop7:Atalho para obter mais detalhes.

Instalar diretório

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 empacotamento MSIX precisará saber para onde todos esses arquivos vão e serão capturados durante a conversão.

Você pode corrigir isso usando a gravação do Package Support Framework para instalar a correção do diretório. Adicionamos isso como uma funcionalidade por padrão na Ferramenta MSIX, o que permite isso até 1809. Se o aplicativo não estiver funcionando em 1709 e estiver em 1809, esse provavelmente será o problema.

Enviar comentários

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

  1. Abra o Hub de Comentários 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 todos os arquivos de log associados à conversão. Você pode encontrar os logs na pasta fornecida acima.
  5. Anexe o pacote MSIX convertido (se possível).
  6. Clique em Enviar.

Você também pode nos enviar comentários diretamente da Ferramenta de Empacotamento MSIX acessando a guia Comentários em Configurações.

Observação

Pode levar 24 horas para recebermos seus comentários. Portanto, se você estiver usando uma VM para converter seu pacote, talvez queira manter sua VM ativada e em seu estado atual por 24 horas após a conversão. Além disso, você pode anexar manualmente os logs de conversão aos comentários.