Compartilhar via

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

  • Artigo

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ê precisa adquirir a ferramenta ou driver MSIX Packaging em ambientes desconectados.

Problemas conhecidos

Obtendo a versão mais recente do Insider Preview da MSIX Packaging Tool

Se você optou pelo 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 MSIX Packaging Tool instalada.
  • Verifique se o MSA que está inscrito para o voo é a conta que está conectada na Microsoft Store.
  • Atualize manualmente a MSIX Packaging Tool através da Microsoft Store no seu computador. Se esta opção estiver disponível para si, abra a Loja, aceda a Transferências e atualizações e clique em Obter atualizações. Como alternativa, procure a Ferramenta de Empacotamento MSIX e, na página do produto, você poderá solicitar uma atualização.
  • Para instalar a MSIX Packaging Tool para uso off-line, siga estas instruções para garantir que você obtenha o aplicativo mais recente por meio de nosso processo off-line.

Se você está interessado em participar do nosso Programa Insider, vá para Junte-se ao MSIX Packaging Tool Insiders!.

Driver da ferramenta de empacotamento MSIX

O driver MSIX Packaging Tool é fornecido como um pacote FOD (Feature on Demand) 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 voo do Windows Insider não corresponderem à compilação do sistema operacional do computador.

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

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

Problemas de conectividade de rede

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

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

Windows Server Update Service (WSUS), 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 diretivas no 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 políticas do ambiente.

Driver necessário uma reinstalação

Nesse cenário, a ferramenta de empacotamento MSIX irá notificá-lo na mensagem de erro e logs 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, quando você verificar o arquivo de log, você deve encontrar uma entrada como a seguinte:

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

Esse erro acontece 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, 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 da á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 MSIX Packaging Tool.

Versão mínima

Há alguns recursos a serem observados que alteram automaticamente o suporte à versão mínima em seu pacote MSIX.

Impor requisitos de controle de versão da Microsoft Store

Se você converter o instalador existente usando uma versão da MSIX Packaging Tool anterior à 1.2019.701.0, a ferramenta tinha Impor requisitos de controle de versão da Microsoft Store ou usava outra ferramenta para criar o pacote que não definia 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 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 TargetDeviceFamily atributo do 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 MSIX Packaging Tool, adicionamos suporte para a criação de um pacote MSIX com Serviços. Devido às restrições do sistema operacional com suporte a serviços, a MSIX Packaging Tool altera automaticamente a versão min suportada 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 você pode criar esse MSIX usando a ferramenta de empacotamento MSIX até o Windows 10 1809. Se você precisar instalar este aplicativo em um sistema operacional inferior, atualize a versão min apropriadamente, mas observe que o suporte para serviços não funcionará.

Estruturas e drivers

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 a instalação de um driver, você precisará avaliar se isso é necessário para que o aplicativo seja executado corretamente. MSIX atualmente não oferece suporte à instalação de driver.

Computador remoto

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

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 dumpbin.exe /headers comando para despejar os cabeçalhos de arquivo e inspecionar se há elementos defeituosos. Reescreva manualmente os cabeçalhos para corrigir o problema. Em geral, a ferramenta MSIX Packaging detecta automaticamente cabeçalhos defeituosos. Se esse problema persistir, envie comentários sobre o arquivo. Encontre mais informações aqui.

Assinatura do Device Guard

Certifique-se de seguir estas etapas e que você está atribuindo as funções apropriadas na Microsoft Store para Empresas.

Certificado expirado

  • Use um carimbo de data/hora ao assinar seu pacote.
  • Você pode renunciar com um sinal válido ou certificado de carimbo de data/hora.

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

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 benéfico se você pudesse compartilhar toda a pasta Logs que incluirá as operações que ocorrem no cliente local, bem como no servidor remoto.

Problemas comuns

Erros de tradução do MakePri/Manifest

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

Associações de tipo de arquivo

Os problemas relacionados a associações de tipo de arquivo (FTA) variam de pacote para pacote. A MSIX Packaging Tool oferece suporte a associações de arquivos para instalações com duplo clique. 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 MSIX Packaging capturará todos os atalhos de nível de usuário junto com os argumentos. Caso esses atalhos não sejam detectados corretamente, você pode adicioná-los manualmente ao manifesto. Consulte desktop7:Atalho para obter mais detalhes.

Diretório de instalação

Isso é mais comum para aqueles que usam uma unidade secundária para realizar conversões de aplicativos. 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 MSIX Packaging 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 de diretório. Adicionamos isso como um recurso por padrão na ferramenta MSIX, que permite isso até 1809. Se o seu aplicativo não estiver funcionando em 1709 e estiver em 1809, esse provavelmente é o problema.

Como enviar comentários

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

  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 logs de conversão aos comentários.